AGENTS.md · diff

git:20260521.49efe94 to git:20260929.1d271df

0 added, 25 removed. Audit A to A.

# Skills Repository

`usetemi/skills` publishes Temi agent skills for coding agents and tools that

support the Agent Skills spec. Keep this file focused on instructions agents need

while changing the repo; keep public install, catalog, and distribution copy in

`README.md`.

## Orientation

- Each skill is self-contained under `skills/<name>/`. `SKILL.md` is the required

entry point; deeper references should live inside the skill and be loaded only

when the task calls for them.

- `README.md` is the canonical public catalog and install guide. Update it when a

skill is added, removed, renamed, or its public description changes.

- Plugin and marketplace metadata lives under `.claude-plugin/`,

`.codex-plugin/`, and `.agents/plugins/`. Touch those files only for registration

or metadata changes.

- - `template/` renders shared Python modules for the google-* CLI skills. Read

- `template/AGENTS.md` before editing the Copier template or any file generated

- from it.

## Skill Changes

- When adding a new skill, create `skills/<name>/SKILL.md` and keep the skill

directory self-contained.

- Register new skills in `.claude-plugin/marketplace.json` and add a row to the

`README.md` skill table.

- Codex discovers skills from `./skills/` via `.codex-plugin/plugin.json`, so new

skills do not need per-skill Codex registration unless root plugin metadata

changes.

- Do not document capabilities that are not implemented in the skill.

- ## Copier-Rendered Google Skills

- The google-* Python CLI skills share modules rendered from `template/`. If you

- change a template or a rendered shared module, re-render each affected consuming

- skill from that skill's directory:

- ```bash

- copier copy --data-file .copier-answers.yml --defaults --trust --overwrite ../../template .

- ```

- Commit the template change and regenerated outputs together. The

- `copier-drift.yml` workflow runs the same `copier copy --overwrite` flow and fails

- if rendered files drift.

## Validation

- - For Python CLI skills, run:

- ```bash

- uv run --project skills/<skill> ruff check .

- uv run --project skills/<skill> ty check

- ```

- - After editing `template/**`, run the Copier re-render command for each affected

- skill with a `.copier-answers.yml` file and confirm the diff contains only

- intended changes.

- For docs-only edits, re-read the changed guidance and check for duplicated

README content, stale file indexes, or command drift.

- Before finishing, run `git diff --check`.