git:20260405.2bc344f to git:20260405.31e0ac2

2 added, 2 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.

+ - Install skills with `npx skills add ckorhonen/swe-skills`.

+ - Document install examples using `npx skills add ckorhonen/swe-skills`, 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.