git:20260404.9370c32 to git:20260405.2bc344f

25 added, 0 removed. Audit A to A.

# SWE Skills & Eval Suite

This repository stores AI skill files and evaluation suites for SWE workflows.

## Repository scope

- `skills/` contains skill definitions.

- `evals/` contains evaluation suites and fixtures.

- `README.md` is the primary overview and usage guide for the repository.

## Naming convention

- Every skill identifier/name must be prefixed with `swe:`.

- Avoid creating new skill names that do not start with `swe:`.

## Installation

- Install skills with `npx skills install`.

- Document install examples using `npx skills install`, not alternate commands.

+ ## Marketing site (`site/`)

+ - `site/` contains the static marketing website deployed to `cdd.dev/skill/`.

+ - The site showcases all swe: skills with descriptions, example prompts,

+ sample output, and suggested schedules.

+ ### Site sync rules

+ - **Adding a skill**: Add a skill card to the appropriate category section

+ in `site/index.html`. Include the skill name, one-line description, and an

+ example prompt. Add it to the relevant schedule card in the Schedules

+ section. Update the skill count in the hero lede, Framework section, and

+ page title if the total changes.

+ - **Removing a skill**: Remove the skill card, its schedule entry, and adjust

+ counts accordingly.

+ - **Modifying a skill**: After changing a skill's description, trigger

+ conditions, or output format, review `site/index.html` for accuracy.

+ Update the skill card description, example prompt, or sample output if

+ they no longer reflect the skill's behavior.

+ - **Deploying changes**: After editing `site/`, copy the files to the

+ `cdd-site` repo's `public/skill/` directory, run `npx vite build`, and

+ deploy with `wrangler pages deploy dist --project-name=cdd-site` from

+ the `cdd-site` repo root.

## Workflow notes

- Keep additions narrowly scoped.

- Keep files small and reviewable.

- Before creating or revising anything under `skills/` and the matching

`evals/` assets, use `swe:create-skill` first. It contains the repo-local,

distilled authoring guidance adapted from Anthropic's skill-building guide.

- Co-locate related skill and eval assets in their feature directories.

- Update `README.md` whenever repository structure, install flow, or skill/eval workflows change.

- Do not land changes that make `README.md` materially inaccurate.

+ - Do not land changes to skills without checking `site/index.html` for accuracy.