contribute-propper-skilllisted
Install: claude install-skill mypropper/skills
# Contributing to mypropper/skills
Applies inside the `mypropper/skills` checkout. The repo root **is** the plugin: skills
live in `skills/<name>/SKILL.md` and the manifests sit in `.claude-plugin/`.
## Before you finish, run these
```bash
node scripts/check-repo.mjs # structural checks — the same ones CI runs
claude plugin validate . --strict # marketplace manifest
claude plugin validate .claude-plugin/plugin.json --strict
claude plugin validate skills --strict
```
All four must pass with zero warnings. CI runs the same commands on every PR.
For a change to a skill body or description, also run the evals:
```bash
claude plugin eval --trust-plugin --no-publish --runs 2 -j 4 --judge-model sonnet
```
Use `--judge-model sonnet`. These graders check several conditions per case, which is
above what the default judge adjudicates reliably. Record the score and the no-plugin
baseline delta in the PR. Do not claim a skill works without them.
## Adding a skill
1. `skills/<name>/SKILL.md`, where `<name>` matches the directory exactly.
2. Frontmatter is `name` and `description` only, plus `user-invocable: false` for a skill
that exists to be referenced rather than triggered.
3. Open with the prerequisite block when the skill needs Propper tools:
```markdown
> **PREREQUISITE:** Use the `propper` skill for authentication, tool routing, and the
> agreement status model.
```
4. Add at least one eval case under `evals/`.
### The description is the tr