AGENTS.md · diff

git:20260429.08febae to git:20260518.179cd62

9 added, 1 removed. Audit A to A.

# Skills Repository
`usetemi/skills` is an open-source repository of agent skills published by [Temi](https://usetemi.com). Skills extend AI agents (Claude Code, Claude Cowork, Codex, Cursor, Gemini CLI, and others that support the [Agent Skills spec](https://agentskills.io)) with specialized knowledge, workflows, and tools.
This repo serves both as:
+ - A **Codex plugin marketplace** (`codex plugin marketplace add usetemi/skills`)
- A **Claude Code plugin marketplace** (`/plugin marketplace add usetemi/skills`)
- A **skills.sh-compatible** package (`npx skills add usetemi/skills`)
## Repository Structure
```
skills/
+ ├── .agents/plugins/
+ │ └── marketplace.json # Codex marketplace configuration
├── .claude-plugin/
│ └── marketplace.json # Claude Code marketplace configuration
+ ├── .codex-plugin/
+ │ └── plugin.json # Codex plugin manifest for the repo-root skills bundle
├── .github/workflows/
│ ├── release.yml # Per-skill zip artifacts on tag push
│ └── copier-drift.yml # Fails PRs where rendered files diverge from template/
├── skills/ # All skills live here
│ └── <skill-name>/
│ ├── SKILL.md # Required entry point
│ └── .copier-answers.yml # (google-* skills) Copier substitutions for templated modules
├── template/
│ ├── SKILL.md # Starting template for new skills
│ ├── copier.yml # Copier template config — see template/AGENTS.md
│ └── src/{{ pkg }}/ # Jinja templates rendered into each consuming skill
└── AGENTS.md # This file (shared agent instructions)
```
## Shared modules across the google-* skills
`template/` is also a [Copier](https://copier.readthedocs.io/) template that renders shared modules (`__init__.py`, `__main__.py`, `auth.py`) into each google-* skill. Each consuming skill carries a `.copier-answers.yml` recording its substitution values. To re-render after editing a template, run from inside the skill's directory:
```bash
copier copy --data-file .copier-answers.yml --defaults --trust --overwrite ../../template .
```
Commit both the template change and the regenerated outputs. `.github/workflows/copier-drift.yml` enforces this on PRs. Detailed authoring guide: [`template/AGENTS.md`](template/AGENTS.md).
## Creating a new skill
Use Anthropic's `skill-creator` for the design, structure, and validation workflow:
```bash
npx skills add https://github.com/anthropics/skills --skill skill-creator
```
References:
- [skills.sh/anthropics/skills/skill-creator](https://skills.sh/anthropics/skills/skill-creator)
- [SKILL.md source](https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md)
- After scaffolding, register the new skill in this repo: add its path to the `skills` array in `.claude-plugin/marketplace.json` and add a row to the table in `README.md`.
+ After scaffolding, register the new skill in this repo: add its path to the `skills` array in `.claude-plugin/marketplace.json` and add a row to the table in `README.md`. The Codex plugin manifest points at `./skills/`, so new skills do not need a separate Codex plugin registration unless the root plugin metadata changes.
## Releasing
A `v*` tag (e.g. `v0.1.0`) triggers `.github/workflows/release.yml`, which zips each `skills/*` directory and attaches the zips to a GitHub Release. Cowork/Desktop users download the zip they want.
## Distribution
```bash
+ # Codex plugin marketplace
+ codex plugin marketplace add usetemi/skills
+
# Claude Code plugin marketplace
/plugin marketplace add usetemi/skills
/plugin install usetemi@usetemi
# skills.sh (Codex, Cursor, Gemini CLI, etc.)
npx skills add usetemi/skills
```