mirror of https://github.com/getsentry/skills.git synced 2026-09-14 20:00:03 +08:00

Files

T

David Cramer fe1dd4f1d4 docs(skills): List all skills and align registration/allowlists (#80 )

* 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>

2026-03-04 10:44:54 -08:00

1.3 KiB

Raw Permalink Blame History

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

Create plugins/sentry-skills/skills/<skill-name>/SKILL.md
Add to README.md Available Skills table (alphabetical by skill name)
Add to .claude/settings.json: Skill(sentry-skills:<skill-name>)
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

1.3 KiB Raw Permalink Blame History