DEVELOPMENT WORKFLOW / getsentry
Evidence-Based Skill Writing
Choose a skill structure, preserve source adaptation decisions and iterate against working and holdout examples.
“Create, synthesize, and iteratively improve agent skills following the Agent Skills specification. …”
01 / THE REASONING
Why this made the selection.
- SKILL.md is a router: each bundled reference is loaded only for the step that needs it, not all at once.
- Adapting an upstream document is a rewrite into local decisions, and the validator only checks structure and that referenced files exist.
- The source-adaptation reference requires intent, fidelity, local replacements, omitted material, provenance and rights to be recorded, with a precision pass before adding structure.
- Adapt an upstream workflow with explicit provenance and fidelity boundaries
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/skill-writer/SKILL.md
- skills/skill-writer/references/source-adaptation.md
- skills/skill-writer/references/registration-validation.md
- skills/skill-writer/scripts/quick_validate.py
- LICENSE
- README.md
Our findings
- The skill reads and writes local skill files. It does not call a model-eval service unless the request is specifically for evals, which it routes to another reference.
- Source adaptation forbids copying the upstream section structure unless that structure helps at runtime, and it keeps licence and attribution notes in SOURCES.md.
- The bundled validator checks frontmatter and that referenced files exist. It does not execute the skill being written.
- The source-adaptation reference requires intent, fidelity, local replacements, omitted material, provenance and rights to be recorded, with a precision pass before adding structure.
- Target resolution starts from repository conventions and records portability implications before provider-specific mechanics; every new reference needs a direct routing entry and a reason to load it.
Not established by this review
- The resource was not executed and its tools were not called.
- quick_validate.py was not run, and no skill was created.
- No skill execution, authenticated service operation, or outcome benchmark was performed.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add getsentry/skills/skills/skill-writer Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/getsentry/skills/tree/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/skill-writer - Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Choose creation/update/iteration mode and the simplest suitable structure before authoring.
- Record source versions, rights and omitted material in provenance notes; validate routing and retain relevant examples.
Before you start
- A target skill repository and its registration conventions
- Source material and representative task examples
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Pinned skill definition ↗Checked
https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/skill-writer/SKILL.md
Supports: summary, whySelected, bestFor, limitations, install, access, review
https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/README.md
Supports: install
- Apache-2.0 licence ↗Checked
https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/LICENSE
Supports: license
https://github.com/getsentry/skills/blob/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/skill-writer/references/source-adaptation.md
Supports: review, limitations, access, install
https://raw.githubusercontent.com/getsentry/skills/d18b7aa8ba878354e5c348310230e652f7690f9c/skills/skill-writer/SKILL.md
Supports: review.findings, bestFor, upstreamDescription