{"_id":"@10up/agent-skills","_rev":"6-230dd9c7e901c9a3ab3c6b1aa953494a","name":"@10up/agent-skills","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@10up/agent-skills","version":"0.1.0","keywords":["10up","wordpress","gutenberg","ai","agent","skills","claude","cursor","copilot"],"author":{"name":"10up"},"license":"MIT","_id":"@10up/agent-skills@0.1.0","maintainers":[{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},{"name":"brandwaffle","email":"vhauri@gmail.com"},{"name":"eugene-manuilov","email":"eugene.manuilov@gmail.com"},{"name":"christianc1","email":"christian.m.chung@gmail.com"},{"name":"nicholasio","email":"nicholasio.oliveira@gmail.com"},{"name":"joesnellpdx","email":"joesnellpdx@gmail.com"},{"name":"tlovett1","email":"tlovett88@gmail.com"},{"name":"devinle","email":"devin.leggett@gmail.com"},{"name":"darylldoyle","email":"daryll.doyle@10up.com"}],"homepage":"https://github.com/10up/agent-skills#readme","bugs":{"url":"https://github.com/10up/agent-skills/issues"},"bin":{"10up-agent-skills":"shared/scripts/skillpack-install.mjs"},"dist":{"shasum":"faacb72eb879aa789c2e0d62ada3c66c3095860d","tarball":"https://registry.npmjs.org/@10up/agent-skills/-/agent-skills-0.1.0.tgz","fileCount":44,"integrity":"sha512-EdMS7WYkHGW+rh55gnbNTjp/GmyPznFBHUhhdNaZcg19PPH4NLTFaKAqa7Jv36IJkWjWyRL1Q4HN8heNt/ntOA==","signatures":[{"sig":"MEUCICQ1W4pzsqhb3Eqcw7gm/gaAYWXe/EXAfuP4YcWu2RDpAiEAjtyt+nKW9tS5/o5Szqpt9uvmMMt6eGNJeRKTrVJw7MQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":379815},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"5855409b31109eb7c430b6c2c43b3e2743fc0a8e","_npmUser":{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},"repository":{"url":"git+https://github.com/10up/agent-skills.git","type":"git"},"_npmVersion":"11.7.0","description":"Teach AI coding assistants how to build WordPress the 10up way","directories":{},"_nodeVersion":"23.5.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-skills_0.1.0_1768250005232_0.24281133981435055","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@10up/agent-skills","version":"0.1.1","keywords":["10up","wordpress","gutenberg","ai","agent","skills","claude","cursor","copilot"],"author":{"name":"10up"},"license":"MIT","_id":"@10up/agent-skills@0.1.1","maintainers":[{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},{"name":"brandwaffle","email":"vhauri@gmail.com"},{"name":"eugene-manuilov","email":"eugene.manuilov@gmail.com"},{"name":"christianc1","email":"christian.m.chung@gmail.com"},{"name":"nicholasio","email":"nicholasio.oliveira@gmail.com"},{"name":"joesnellpdx","email":"joesnellpdx@gmail.com"},{"name":"tlovett1","email":"tlovett88@gmail.com"},{"name":"devinle","email":"devin.leggett@gmail.com"},{"name":"darylldoyle","email":"daryll.doyle@10up.com"}],"homepage":"https://github.com/10up/agent-skills#readme","bugs":{"url":"https://github.com/10up/agent-skills/issues"},"bin":{"10up-agent-skills":"shared/scripts/skillpack-install.mjs"},"dist":{"shasum":"b2957093d464112c08aa836fdcb322cddfeffb28","tarball":"https://registry.npmjs.org/@10up/agent-skills/-/agent-skills-0.1.1.tgz","fileCount":46,"integrity":"sha512-wJwD1eDYsROsOtVJQVfAYkE09ncMZeJo2e4fPWgm+lFEo1x0GC5wOpeJEkptfTp5AT4DpQwkBmKNuFunEeNJjw==","signatures":[{"sig":"MEUCIFjT506CXbm9IA2eDDHYUhBfsjltcApb7SXJF2r7lOhkAiEA5ylfgZupVSuzqdwg+VJIL7pwikeozoO8NJPYBvywl4E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":395663},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"d573df0fe394a4c49ea4c51258bb50a10a7a94b5","_npmUser":{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},"repository":{"url":"git+https://github.com/10up/agent-skills.git","type":"git"},"_npmVersion":"11.7.0","description":"Teach AI coding assistants how to build WordPress the 10up way","directories":{},"_nodeVersion":"23.5.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-skills_0.1.1_1768253133537_0.7397147505888737","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@10up/agent-skills","version":"0.1.2","keywords":["10up","wordpress","gutenberg","ai","agent","skills","claude","cursor","copilot"],"author":{"name":"10up"},"license":"MIT","_id":"@10up/agent-skills@0.1.2","maintainers":[{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},{"name":"brandwaffle","email":"vhauri@gmail.com"},{"name":"eugene-manuilov","email":"eugene.manuilov@gmail.com"},{"name":"christianc1","email":"christian.m.chung@gmail.com"},{"name":"nicholasio","email":"nicholasio.oliveira@gmail.com"},{"name":"joesnellpdx","email":"joesnellpdx@gmail.com"},{"name":"tlovett1","email":"tlovett88@gmail.com"},{"name":"devinle","email":"devin.leggett@gmail.com"},{"name":"darylldoyle","email":"daryll.doyle@10up.com"}],"homepage":"https://github.com/10up/agent-skills#readme","bugs":{"url":"https://github.com/10up/agent-skills/issues"},"bin":{"10up-agent-skills":"shared/scripts/skillpack-install.mjs"},"dist":{"shasum":"053865ec1fdce875bd846ed5128f75db78e25bdd","tarball":"https://registry.npmjs.org/@10up/agent-skills/-/agent-skills-0.1.2.tgz","fileCount":46,"integrity":"sha512-neMGEAS0fbVSiNlzCZ9pB+h0BIwJXdpZWli3K2JFRA5FDnvMS1LIHugimSKCL+TCCjczVckmYFwkxmLyWtQGIA==","signatures":[{"sig":"MEQCIHVV82VuzxVm8V0ehskeYn7wkImwVQLUrVmAOLAM96eJAiASxjCnCAYi0yZMmenQ9Du3QkbHbDV2SaMK7zciiz5tVA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":398189},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"74deac25728a2db9e48453a25c3bd6794c12bf1e","_npmUser":{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},"repository":{"url":"git+https://github.com/10up/agent-skills.git","type":"git"},"_npmVersion":"11.7.0","description":"Teach AI coding assistants how to build WordPress the 10up way","directories":{},"_nodeVersion":"23.5.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-skills_0.1.2_1768253595774_0.16279471603390316","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@10up/agent-skills","version":"0.1.3","keywords":["10up","wordpress","gutenberg","ai","agent","skills","claude","cursor","copilot"],"author":{"name":"10up"},"license":"MIT","_id":"@10up/agent-skills@0.1.3","maintainers":[{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},{"name":"eugene-manuilov","email":"eugene.manuilov@gmail.com"},{"name":"christianc1","email":"christian.m.chung@gmail.com"},{"name":"nicholasio","email":"nicholasio.oliveira@gmail.com"},{"name":"joesnellpdx","email":"joesnellpdx@gmail.com"},{"name":"devinle","email":"devin.leggett@gmail.com"},{"name":"darylldoyle","email":"daryll.doyle@10up.com"}],"homepage":"https://github.com/10up/agent-skills#readme","bugs":{"url":"https://github.com/10up/agent-skills/issues"},"bin":{"10up-agent-skills":"shared/scripts/skillpack-install.mjs"},"dist":{"shasum":"ec74a7317682b36c35714e34115a2ace88e8e33d","tarball":"https://registry.npmjs.org/@10up/agent-skills/-/agent-skills-0.1.3.tgz","fileCount":61,"integrity":"sha512-/SP/QZjhEuWa6GEU6EX6/yLYdxsvCzoLvGDH63lwDxA1DqcHmEGnf2iAbDtHI2nVXU3z4KcRAaY+B8maKK14Ng==","signatures":[{"sig":"MEUCIEK9DtLRrmseW/gt/5VkjyeS0pQNSsQbentBSfT0p+QKAiEA6RdAQFdB3he9RXZDRpSx8Vy7Fft5A25ZPT0bHoD+CtA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":547554},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"9aed932046df9799ba56a857db8b91eb0e1c236f","_npmUser":{"name":"fabiankaegy","email":"mail@fabian-kaegy.de"},"repository":{"url":"git+https://github.com/10up/agent-skills.git","type":"git"},"_npmVersion":"11.8.0","description":"Teach AI coding assistants how to build WordPress the 10up way","directories":{},"_nodeVersion":"25.4.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-skills_0.1.3_1770241219735_0.39371441358887216","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-01-12T20:33:25.146Z","modified":"2026-08-21T19:38:44.564Z","0.1.0":"2026-01-12T20:33:25.384Z","0.1.1":"2026-01-12T21:25:33.693Z","0.1.2":"2026-01-12T21:33:15.965Z","0.1.3":"2026-02-04T21:40:19.934Z"},"bugs":{"url":"https://github.com/10up/agent-skills/issues"},"author":{"name":"10up"},"license":"MIT","homepage":"https://github.com/10up/agent-skills#readme","keywords":["10up","wordpress","gutenberg","ai","agent","skills","claude","cursor","copilot"],"repository":{"url":"git+https://github.com/10up/agent-skills.git","type":"git"},"description":"Teach AI coding assistants how to build WordPress the 10up way","maintainers":[{"email":"mail@fabian-kaegy.de","name":"fabiankaegy"},{"email":"eugene.manuilov@gmail.com","name":"eugene-manuilov"},{"email":"christian.m.chung@gmail.com","name":"christianc1"},{"email":"nicholasio.oliveira@gmail.com","name":"nicholasio"},{"email":"joesnellpdx@gmail.com","name":"joesnellpdx"},{"email":"devin.leggett@gmail.com","name":"devinle"},{"email":"daryll.doyle@10up.com","name":"darylldoyle"},{"email":"jeffpaul@hotmail.com","name":"jeffpaul"}],"readme":"# 10up Agent Skills\n\n**Teach AI coding assistants how to build WordPress the 10up way.**\n\nAgent Skills are portable bundles of instructions, checklists, and scripts that help AI assistants (Claude, Cursor, Copilot, VS Code, etc.) understand WordPress development patterns, avoid common mistakes, and follow [10up engineering best practices](https://10up.github.io/Engineering-Best-Practices/) and the [10up Gutenberg Best Practices](https://gutenberg.10up.com/).\n\nThis project follows the [agentskills.io specification](https://agentskills.io/specification).\n\n> **Inspired by [Automattic's agent-skills](https://github.com/Automattic/agent-skills)**\n>\n> This project was inspired by and builds upon the pioneering work done by Automattic in creating agent skills for WordPress development. We've adapted their approach to focus specifically on 10up's engineering patterns, tooling, and best practices. Thank you to the Automattic team for open-sourcing their work and establishing the foundation for AI-assisted WordPress development.\n\n## Why Agent Skills?\n\nAI coding assistants are powerful, but they often:\n\n- Generate outdated WordPress patterns (pre-Gutenberg, pre-block themes)\n- Use static blocks instead of dynamic blocks with PHP rendering\n- Miss critical security considerations in plugin development\n- Skip proper block deprecations, causing \"Invalid block\" errors\n- Ignore 10up tooling and conventions in your repo\n- Don't know about the Interactivity API or modern block patterns\n\nAgent Skills solve this by giving AI assistants **expert-level 10up WordPress knowledge** in a format they can actually use.\n\n## Available Skills\n\n| Skill | What it teaches |\n|-------|-----------------|\n| **10up-router** | Classifies WordPress repos and routes to the right 10up workflow |\n| **10up-project-triage** | Detects project type, 10up tooling, and versions automatically |\n| **10up-block-development** | Gutenberg blocks: `block.json`, dynamic rendering, attributes, deprecations |\n| **10up-block-themes** | Block themes: `theme.json`, templates, patterns, style variations |\n| **10up-css** | CSS architecture, ITCSS methodology, accessibility, specificity, naming conventions |\n| **10up-plugin-development** | Plugin architecture with 10up PHP framework (ModuleInterface) |\n| **10up-interactivity-api** | Frontend interactivity with `data-wp-*` directives and stores |\n| **10up-inner-blocks** | Block composition with InnerBlocks, templates, and locking |\n| **10up-block-extensions** | Extending core blocks with @10up/block-components |\n| **10up-block-patterns** | Block patterns, synced patterns, and block bindings API |\n| **10up-toolkit** | 10up-toolkit build system configuration and troubleshooting |\n| **10up-scaffold** | WP Scaffold for theme and plugin development |\n| **10up-wp-framework** | 10up PHP framework with ModuleInterface and auto-loading |\n| **10up-testing** | PHPUnit, Jest, and Cypress testing strategies |\n| **10up-performance** | Performance profiling, caching, and optimization |\n| **10up-commit-messages** | Conventional commit messages with 10up style |\n\n## Quick Start\n\n### Option 1: Install via npx (Recommended)\n\n```bash\n# Navigate to your project\ncd your-wp-project\n\n# Install all skills to your project\nnpx @10up/agent-skills\n\n# Or install specific skills only\nnpx @10up/agent-skills --skills=10up-router,10up-block-development\n\n# Install for multiple editors\nnpx @10up/agent-skills --targets=claude,cursor,vscode\n```\n\nThis copies skills into:\n- `.claude/skills/` for Claude Code (project-level)\n- `.cursor/rules/` for Cursor\n- `.github/skills/` for VS Code / GitHub Copilot\n\n### Option 2: Install globally for Claude Code\n\n```bash\n# Install all skills globally (available across all projects)\nnpx @10up/agent-skills --global\n\n# Or install specific skills only\nnpx @10up/agent-skills --global --skills=10up-block-development,10up-interactivity-api\n```\n\nThis installs skills to `~/.claude/skills/` where Claude Code will automatically discover them.\n\n### Option 3: Manual installation\n\nCopy any skill folder from `skills/` into your project's instructions directory:\n\n| AI Assistant | Location |\n|--------------|----------|\n| Claude Code (global) | `~/.claude/skills/` |\n| Claude Code (project) | `.claude/skills/` |\n| Cursor | `.cursor/rules/` or `.cursorrules` file |\n| VS Code / Copilot | `.github/skills/` |\n| Windsurf | `.windsurfrules` file |\n\n## Cursor Setup\n\nCursor supports custom rules through a `.cursorrules` file or the `.cursor/rules/` directory.\n\n### Method 1: Using .cursorrules file\n\nCreate a `.cursorrules` file in your project root and paste the contents of the skills you want:\n\n```bash\n# Concatenate skills into a single .cursorrules file\ncat skills/10up-router/SKILL.md > .cursorrules\necho \"\\n---\\n\" >> .cursorrules\ncat skills/10up-block-development/SKILL.md >> .cursorrules\n```\n\n### Method 2: Using .cursor/rules/ directory\n\n```bash\n# Create the rules directory\nmkdir -p .cursor/rules\n\n# Copy skill files\ncp skills/10up-router/SKILL.md .cursor/rules/10up-router.md\ncp skills/10up-block-development/SKILL.md .cursor/rules/10up-block-development.md\ncp skills/10up-block-development/references/*.md .cursor/rules/\n```\n\n### Method 3: Reference in Cursor settings\n\nAdd to your Cursor settings (`.cursor/settings.json`):\n\n```json\n{\n  \"cursor.rules\": {\n    \"include\": [\n      \"skills/10up-*/SKILL.md\",\n      \"skills/10up-*/references/*.md\"\n    ]\n  }\n}\n```\n\n### Cursor with @-mentions\n\nOnce rules are loaded, you can reference them in Cursor with `@rules`:\n\n```\n@rules Create a new block called hero-section following 10up standards\n```\n\n## How It Works\n\nEach skill contains:\n\n```\nskills/10up-block-development/\n├── SKILL.md              # Main instructions (when to use, procedure, verification)\n├── references/           # Deep-dive docs on specific topics\n│   ├── block-json.md\n│   ├── deprecations.md\n│   └── ...\n└── scripts/              # Deterministic helpers (detection, validation)\n    └── list_blocks.mjs\n```\n\nWhen you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing.\n\n### Example: What the AI learns\n\nWithout skills, an AI might generate:\n```javascript\n// Static block with hardcoded HTML (bad for 10up projects)\nsave: ({ attributes }) => {\n    return <div className=\"my-block\">{attributes.content}</div>;\n}\n```\n\nWith 10up skills, it generates:\n```javascript\n// Dynamic block with PHP rendering (10up standard)\nsave: () => null  // Render handled by markup.php\n```\n\n```php\n// markup.php\n<?php\n$wrapper_attributes = get_block_wrapper_attributes();\n?>\n<div <?php echo $wrapper_attributes; ?>>\n    <?php echo wp_kses_post($attributes['content']); ?>\n</div>\n```\n\n## Usage Examples\n\nOnce installed, simply ask your AI assistant to help with WordPress development:\n\n**Block Development:**\n- \"Create a new block called 'hero-section' with a title and background image\"\n- \"Add a toggle setting to control whether the CTA button is displayed\"\n- \"Fix this block deprecation error - the block shows as invalid\"\n- \"Make this block interactive using the Interactivity API\"\n\n**Theme Development:**\n- \"Set up the theme.json with a custom color palette\"\n- \"Create a header template part with navigation\"\n- \"Add a card pattern with image, title, and description\"\n\n**Plugin Development:**\n- \"Create a new plugin following 10up architecture\"\n- \"Add a settings page with a toggle option\"\n- \"Register a custom REST endpoint\"\n\n**General:**\n- \"What type of project is this?\" (triggers triage)\n- \"How should I structure this feature?\"\n\n## Validation\n\nValidate that all skills follow the correct structure:\n\n```bash\nnode eval/harness/run.mjs\n```\n\nThis checks:\n- SKILL.md exists with valid frontmatter\n- Required fields (name, description) are present\n- Name format follows conventions\n- File references are valid\n\n## Compatibility\n\n- **WordPress 6.4+** (PHP 8.0+)\n- **10up-toolkit** projects (recommended)\n- Works with vanilla WordPress projects too\n\n## Contributing\n\nWe welcome contributions! This project is a great way to share your WordPress and 10up expertise.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.\n\n### Quick commands\n\n```bash\n# Install skills to your project\nnpx @10up/agent-skills\n\n# Install skills globally for Claude Code\nnpx @10up/agent-skills --global\n\n# Validate all skills\nnode eval/harness/run.mjs\n\n# Validate a specific skill\nnode eval/harness/run.mjs 10up-block-development\n```\n\n## Project Structure\n\n```\nagent-skills/\n├── skills/                    # Individual skill modules\n│   ├── 10up-router/\n│   ├── 10up-project-triage/\n│   ├── 10up-block-development/\n│   └── ...\n├── shared/\n│   └── scripts/               # Build and install tools\n├── eval/\n│   └── harness/               # Validation tools\n├── docs/                      # Additional documentation\n├── CONTRIBUTING.md\n├── PLAN.md                    # Implementation roadmap\n└── README.md\n```\n\n## Resources\n\n- [Automattic's agent-skills](https://github.com/Automattic/agent-skills) — The original inspiration for this project\n- [10up Gutenberg Best Practices](https://10up.github.io/gutenberg-best-practices/)\n- [10up Engineering Best Practices](https://10up.github.io/Engineering-Best-Practices/)\n- [agentskills.io Specification](https://agentskills.io/specification)\n- [WordPress Block Editor Handbook](https://developer.wordpress.org/block-editor/)\n- [Cursor Rules Documentation](https://docs.cursor.com/context/rules-for-ai)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}