mirror of
https://github.com/getsentry/skills.git
synced 2026-09-14 20:00:03 +08:00
David Cramer
fe1dd4f1d4
* docs: list all available skills * docs(skills): Align registration guidance and skill allowlists Require alphabetical ordering when updating the Available Skills table\nin contributor guidance and skill creation workflow docs.\n\nSynchronize skill allowlists with the actual sentry-skills directory so\nautomatic skill injection guidance reflects all available skills.\n\nCo-Authored-By: GPT-5 Codex <noreply@openai.com> --------- Co-authored-by: shuofengzhang <sofuncheung16@gmail.com>
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# Agent Instructions
|
|
|
|
## Skill Structure
|
|
```
|
|
plugins/sentry-skills/skills/<skill-name>/SKILL.md
|
|
```
|
|
|
|
## Creating/Updating Skills
|
|
ALWAYS use `/skill-writer` — it handles requirements, writing, registration, and validation. (`/skill-creator` remains an alias.)
|
|
|
|
### Registration Checklist
|
|
1. Create `plugins/sentry-skills/skills/<skill-name>/SKILL.md`
|
|
2. Add to `README.md` Available Skills table (alphabetical by skill name)
|
|
3. Add to `.claude/settings.json`: `Skill(sentry-skills:<skill-name>)`
|
|
4. Add to allowlist in `plugins/sentry-skills/skills/claude-settings-audit/SKILL.md`
|
|
|
|
## Key Conventions
|
|
- Frontmatter `---` must be the **first line** of SKILL.md — no comments before it
|
|
- `name` field must match the directory name exactly
|
|
- `description` includes trigger keywords — this is how agents discover the skill
|
|
- Attribution comments go **after** the closing `---`
|
|
- Python scripts: always use `uv run <script>`, never `python` or `python3`
|
|
- Keep SKILL.md under 500 lines; move reference material to `references/`
|
|
|
|
## Commit Attribution
|
|
AI commits MUST include:
|
|
```
|
|
Co-Authored-By: (the agent model's name and attribution byline)
|
|
```
|
|
|
|
## References
|
|
- Skill template and optional fields: `README.md`
|
|
- Testing and PR workflow: `CONTRIBUTING.md`
|
|
- [Agent Skills Spec](https://agentskills.io/specification)
|