OPEN-SOURCE AGENT SKILLS PACK · 8 SPECIALIST DISCIPLINESMIT LICENSE

WebDev Pro Skills

A curated, token-efficient web-development skill stack for AI coding agents.

WebDev Pro Skills is an open-source Agent Skills collection designed to give coding agents deep frontend taste, application UX discipline, hardware-accelerated motion, technical SEO, Core Web Vitals optimization, WCAG 2.2 accessibility, full-stack browser testing, and 8-point production release audits. Built on the SKILL.md standard with progressive disclosure to minimize context footprint.

npx skills install

# Install full 8-skill pack into active coding agent:

npx skills add pokhrelboss/webdev-pro-skills
✓ 8 specialist disciplines
✓ Two-tier progressive disclosure (<1.5k tokens / skill)
✓ Verified for Claude Code, Codex, Cursor & Antigravity

Why I Built WebDev Pro Skills

Modern LLMs are proficient at generating code syntax, but without strict domain guidance they routinely produce generic AI aesthetic tells ("AI slop"), un-accelerated CSS animations causing layout thrashing, inaccessible component markup, broken canonical tags, and superficial unit tests that never verify DOM rendering.

Instead of polluting the agent's context window with dozens of uncoordinated prompt dumps, WebDev Pro Skills packages opinionated professional craftsmanship into 8 cohesive specialist disciplines using a two-tier progressive disclosure architecture.

08/ Specialist Disciplines

The 8 Specialist Skills

Each skill operates with clear activation triggers, hard anti-patterns, and modular on-demand reference guides.

design-taste-frontend
Visual Craft

Anti-slop frontend craft, brief inference, 3 design dials (variance, motion, density), sans-first typography, and layout diversification.

Trigger: Landing pages, marketing sites, brand redesigns, creative portfolios.
--skill design-taste-frontend
ui-ux-pro
Product Architecture

Application UX intelligence, 4 application states (Loading, Empty, Populated, Error), high-density data tables, and inline form feedback.

Trigger: SaaS dashboards, admin consoles, settings, data-heavy portals.
--skill ui-ux-pro
motion-design
Physics & Animation

Purposeful 60fps web physics, hardware-accelerated transform/opacity transitions, <300ms interaction timing budgets, and reduced motion.

Trigger: Modals, drawers, micro-interactions, layout transitions, scroll scrubbing.
--skill motion-design
seo-mastery
Discoverability & Search

Technical SEO, canonical integrity, robots.txt, XML sitemaps, JSON-LD Schema.org graphs, Core Web Vitals, and AI search readiness.

Trigger: Search indexing, structured data, canonical tags, AI discoverability.
--skill seo-mastery
frontend-performance
Vitals & Speed

Core Web Vitals (LCP < 2.5s, INP < 200ms, CLS < 0.1), bundle splitting, React re-render optimization, Server Components, and zero-CLS assets.

Trigger: Slow page loads, CWV regression fixes, bundle optimization.
--skill frontend-performance
web-accessibility
WCAG 2.2 AA

Semantic HTML first, 2px visible focus rings, dialog keyboard focus trapping, ARIA discipline, 4.5:1 color contrast, and 44px tap targets.

Trigger: Accessibility audits, keyboard navigation, screen reader support, forms.
--skill web-accessibility
web-testing
Verification

Full-stack testing with Vitest unit tests, route integration assertions, and Playwright real-browser verification loops before release.

Trigger: Unit test suites, Playwright E2E automation, visual DOM validation.
--skill web-testing
final-web-audit
Release Gate

Pre-production 8-point release gate auditing functionality, UI craft, motion, testing, SEO, performance, accessibility, and security.

Trigger: Pre-launch checklists, final release verification, production audits.
--skill final-web-audit

Two-Tier Progressive Disclosure Architecture

To prevent context window bloat, each skill maintains a lightweight SKILL.md (< 1,500 tokens) with high-density decision gates and negative constraints. Comprehensive reference guides, spring physics tables, and test fixtures live in modular references/ files loaded strictly on-demand.

skills/motion-design/
├── SKILL.md (Fast decision gates & anti-patterns ~150 lines / ~1.4k tokens)
└── references/ (Loaded on-demand only when implementing)
    ├── decision-framework.md (High/medium/low frequency taxonomy)
    ├── springs-and-easing.md (Spring damping ratio & bezier formulas)
    ├── ui-animation-recipes.md (Tested GPU-accelerated component code)
    ├── motion-react-patterns.md (motion/react layout & exit animations)
    └── scroll-and-gestures.md (GSAP & touch gesture interaction physics)

Verified Agent Compatibility

Coding Agent / PlatformInstallation MethodSupport Status
Claude Codenpx skills add pokhrelboss/webdev-pro-skillsNative (SKILL.md standard)
OpenAI CodexDirect repo integration / CLI installerFully Supported
Cursor.cursor/rules / Agent Skills importerSupported
Google AntigravitySkills directory plugin configurationNative
Agent Skills StandardAny tool adhering to SKILL.md specificationVerified Compliant

Engineering Logs on WebDev Pro Skills