| name | working-on-ancplua-plugins |
| description | Primary instruction manual for working within the ancplua-claude-plugins monorepo. Use when creating, modifying, or debugging plugins in this repository. |
Skill: working-on-ancplua-plugins
Purpose
This is the primary instruction manual for an agent working within the
ancplua-claude-plugins monorepo. It defines the mandatory conventions, architectural patterns,
and workflows required to contribute safely and effectively.
When to Use
Use this skill when:
- Creating a new plugin: Follow the
publishing.md guide to scaffold correctly.
- Modifying existing plugins: Check
conventions.md to ensure you don't break architecture.
- Debugging issues: Use
testing.md to verify JSON syntax, permissions, and paths.
- Preparing a PR: Run the validation commands listed in
testing.md.
Reference Library
| Resource | Description |
|---|
| Conventions | Critical rules, naming, directory layout, Git flow |
| Publishing | Step-by-step guide to create and release plugins |
| Testing | Validation commands and debugging steps |
Official Documentation
Quick Actions
Validate everything:
./tooling/scripts/local-validate.sh
Check marketplace sync:
./tooling/scripts/sync-marketplace.sh
Validate single plugin:
claude plugin validate plugins/<plugin-name>
Repo Layout
ancplua-claude-plugins/
├── plugins/ # Individual plugins live here
│ └── <plugin-name>/
│ ├── .claude-plugin/plugin.json
│ ├── skills/
│ ├── commands/
│ ├── agents/
│ ├── hooks/
│ └── README.md
├── agents/ # Repo-level Agent SDK experiments
├── skills/ # Repo-level shared skills (like this one)
├── .claude-plugin/ # Marketplace manifest
├── tooling/ # Validation scripts, templates
└── docs/ # Architecture, specs, ADRs
