simonwong__skills/AGENTS.md

AGENTS.md

Repository

This repository contains composable skills organized by purpose:

• skills/writing/: Simplified Chinese writing skills.
• skills/engineering/: Code quality and engineering workflow skills.
• skills/misc/: General-purpose agent utilities.

Each skill lives at skills/<category>/<skill-name>/. Keep its SKILL.md and supporting resources together. Category directories organize skills and must not contain a SKILL.md. Unfinished skills live at in-progress/<skill-name>/ and are not published.

Before changing anything under skills/writing/, read skills/writing/AGENTS.md for writing-specific rules. Before changing anything under in-progress/, read in-progress/AGENTS.md for the shared data contract and dependency graph.

Working Rules

• Read the target skill and its local instructions before editing it.
• Keep changes scoped to the requested skills. Preserve unrelated work.
• Keep skills self-contained. Add supporting files only when the workflow needs them.
• Preserve explicit-invocation settings in both SKILL.md and agents/openai.yaml when present.
• Write agent-facing instructions as short, imperative steps. Keep final-state docs free of migration history and discarded approaches.

Validation

• Validate every changed SKILL.md against the Agent Skills Specification, allowing documented client-specific frontmatter extensions such as disable-model-invocation.
• Check links and paths referenced by changed instructions.
• Run git diff --check before committing.

Agent skills

Issue tracker

Track maintainer work in Linear. Before creating, reading, or updating tickets, read docs/agents/issue-tracker.md.

Domain docs

Single-context: CONTEXT.md at the repo root plus docs/adr/. See docs/agents/domain.md.