# skills/

Skills for this plugin. Each skill lives in its own subdirectory:

```
skills/
  <skill-name>/
    SKILL.md      # required — frontmatter + skill body
    META.md       # required — provenance and audit fields
    references/   # optional — on-demand reference docs
    scripts/      # optional — executable helper scripts
    assets/       # optional — templates, data files, lookup tables
```

**Shared** — both Claude Code and GitHub Copilot CLI read `skills/<name>/SKILL.md`.

To create or improve a skill, run `/skill-author` in a Claude Code session. To review a skill
without modifying it, run `/skill-audit`. Do not write SKILL.md by hand without following the
authoring standard — trigger descriptions and body discipline are required.

## Skills

| Skill | Description |
|---|---|
| `skill-author` | Create or improve a skill from scratch, audit findings, or inline feedback |
| `skill-audit` | Audit a skill directory against the agentskills.io spec and produce a findings report |
| `agent-author` | Author an agent definition file |
| `pc-author` | Create, add, remove, and configure `.pre-commit-config.yaml` |
| `pc-run` | Install, run, autoupdate, and maintain the pre-commit setup |
| `plugin-author` | (Deprecated — see apm-workflow) Create, update, and release plugin scaffolds for the holocron marketplace |
| `marketplace-author` | (Deprecated — see apm-workflow) Add, remove, and update plugin entries in the holocron marketplace manifest |
| `apm-install` | Install or upgrade the apm CLI and set up the agent runtimes it drives (Copilot CLI, Codex, Gemini, generic llm) |
| `apm-workflow` | Author apm.yml, scaffold an apm package/marketplace, install dependencies, and compile/pack/publish/audit apm content |