---
name: aiskillstore-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."
metadata:
  decimalai-skill-id: "bdd74c99-16e0-4376-b8b1-7429e544793d"
  decimalai-version-id: "d3f12501-65c5-4522-ab4e-ed47a951877c"
  decimalai-version: "1"
  decimalai-body-sha256: "30edba2911b4eef85362a3294ce0eeb1ccc62df3d91f21681e347f3e40020360"
  decimalai-name: "aiskillstore/working-on-ancplua-plugins"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/aiskillstore-working-on-ancplua-plugins@1/SKILL.md"
---
# 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](./references/conventions.md) | Critical rules, naming, directory layout, Git flow |
| [Publishing](./references/publishing.md) | Step-by-step guide to create and release plugins |
| [Testing](./references/testing.md) | Validation commands and debugging steps |

## Official Documentation

| Topic | Link |
|-------|------|
| Plugins | [code.claude.com/docs/en/plugins](https://code.claude.com/docs/en/plugins) |
| Skills | [code.claude.com/docs/en/skills](https://code.claude.com/docs/en/skills) |
| Hooks | [code.claude.com/docs/en/hooks](https://code.claude.com/docs/en/hooks) |
| Marketplaces | [code.claude.com/docs/en/plugin-marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) |

## Quick Actions

**Validate everything:**

```bash
./tooling/scripts/local-validate.sh
```

**Check marketplace sync:**

```bash
./tooling/scripts/sync-marketplace.sh
```

**Validate single plugin:**

```bash
claude plugin validate plugins/<plugin-name>
```

## Repo Layout

```text
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
```