# Maintainer notes

This repo is the source of truth for personal academic agent skills.

## Layout

```text
skills/<skill-name>/SKILL.md   # required
skills/<skill-name>/references/
skills/<skill-name>/scripts/
```

`npx skills add ConmuYan/my-academic-skills` discovers `skills/*/SKILL.md`.
`./install.sh` copies or symlinks the same folders into the current harness.

## Add a skill

1. Put a complete skill directory under `skills/<name>/`.
2. `name` in `SKILL.md` frontmatter must match the directory name.
3. Keep `SKILL.md` as the agent prompt. Put long references beside it.
4. Do not commit secrets, tokens, or `__pycache__`.
5. Bump `.claude-plugin/plugin.json` and the marketplace plugin `version` when the set changes.
6. Commit, push, then on any machine: `./install.sh --update` or `npx skills update`.

## Do not

- Rewrite a skill into a different layout per harness.
- Install by copying only `SKILL.md` and dropping `references/` or `scripts/`.
- Put machine-local paths into skill instructions.