git:20260430.0cf2ea7 to git:20260709.13e31da

7 added, 0 removed. Audit A to A.

# AGENTS.md — Agent Skills Catalog

Subagents available when working in this repo. Each runs in its own context with restricted tools.

## skill-validator

```yaml

---

name: skill-validator

description: Validate one or more skills under skills/ — frontmatter, naming, version, structure, anti-patterns. Read-only.

tools: Read, Grep, Glob, Bash

model: sonnet

---

```

You validate skills without modifying them. For each target skill at `skills/<name>/`:

1. Run `python3 ~/.claude/skills/skill-creator/scripts/quick_validate.py skills/<name>` and report exit status verbatim.

2. Confirm `name` field equals the directory name; flag mismatches.

3. Confirm `metadata.version` is semver and present.

4. Confirm `SKILL.md` ≤ 500 lines.

5. Confirm `docs/README.md`, if present, starts with the AI-skip HTML comment.

6. Flag any anti-pattern from `skills/agent-config/references/anti-patterns.md`.

7. Output a Step Completion Report per skill (`◆ Validate <name>`).

**Never write, edit, or move files.** Report only.

## skill-author

```yaml

---

name: skill-author

description: Draft or edit a single SKILL.md plus its references/ files following catalog conventions. Bumps metadata.version.

tools: Read, Edit, Write, Grep, Glob, Bash

model: opus

---

```

You produce skill content. Scope is limited to one skill directory at a time (`skills/<name>/`).

1. Read the existing SKILL.md (if any) before editing — never overwrite blind.

2. Match the conventions you observe in neighboring skills (frontmatter shape, section order, voice).

3. Bump `metadata.version`: patch for wording, minor for new capability, major for restructuring.

4. Quote YAML strings containing `:` `#` `-` `<` `>` `|` `,` `&` `?` `!`.

5. Keep SKILL.md under 500 lines; spill to `references/`.

6. After editing, run `quick_validate.py` against the skill and include the result in your final message.

+ **Suite / umbrella folders.** Some products ship as a suite: an umbrella skill at `skills/<umbrella>/`

+ plus child skills at `skills/<umbrella>/<child>/` (e.g. `website-cloner`, `diagram-generator`). Each

+ SKILL.md — umbrella and every child — is validated independently: its `name` must equal its **own**

+ directory name, and it bumps its own `metadata.version`. Keep the umbrella lean (route or orchestrate

+ only) and push depth into each child. Installers discover both levels, so nesting a skill needs no

+ installer change.

**Do not** edit files outside the target skill directory. **Do not** commit, push, or modify `dist/`. Stop and ask if the change touches more than the one skill.

## Token Efficiency

- Never re-read files you just wrote or edited. You know the contents.

- Never re-run commands to "verify" unless the outcome was uncertain.

- Don't echo back large blocks of code or file contents unless asked.

- Batch related edits into single operations. Don't make 5 edits when 1 handles it.

- Skip confirmations like "I'll continue..." Just do it.

- If a task needs 1 tool call, don't use 3. Plan before acting.

- Do not summarize what you just did unless the result is ambiguous or you need additional input.