AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

skill-writer

Create, synthesize, and iteratively improve agent skills following the Agent Skills specification. Use when asked to "create a skill", "write a skill", "synthesize sources into a skill", "improve a skill from positive/negative examples", "update a skill", or "maintain skill docs and registration". Handles source capture, precision passes, authoring, registration, and validation.

Original source
getsentry
License
Apache-2.0
Pinned revision
d12f250460ffd961f549dbebf7eeb0cf4afd4c2e

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read getsentry--skill-writer at revision d12f250460ffd961f549dbebf7eeb0cf4afd4c2e, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 41

references/iteration-evidence.md

Iteration Evidence

Use this guide when improving a skill from positive examples, negative examples, review feedback, validation results, or observed agent behavior.

Storage Layout

Store persistent improvement evidence under:

references/evidence/
├── findings-log.md
├── working-set.md
└── holdout-set.md

Use this directory only when examples should outlive the current task. For a one-off small fix, summarize the examples in SOURCES.md instead.

File Roles

references/evidence/findings-log.md records interpreted findings:

  • repeated failure patterns
  • preserved success patterns
  • suspected root causes
  • instruction changes made in response
  • unresolved risks

references/evidence/working-set.md stores examples used while editing the skill.

references/evidence/holdout-set.md stores examples reserved for validation after edits. Do not tune directly against holdout examples unless the user explicitly moves them into the working set.

Example Record Schema

Use one record per example:

## EX-001: Short label

- Label: positive | negative
- Kind: true-positive | false-positive | false-negative | fix | regression | edge-case
- Origin: human-verified | mixed | synthetic
- Source: issue/PR/commit/log/user note/local validation pointer
- Status: working | holdout | resolved | deferred
- Expected behavior: concise statement
- Observed behavior: concise statement
- Skill delta: instruction, reference, description, or validation change
- Anonymization: what was removed or generalized

### Content

Summarized or redacted example content.

Keep records concise. Preserve enough detail to reproduce the behavior, but redact secrets, customer data, private URLs, and unnecessary user content.

Positive And Negative Findings

Positive findings are not just success stories. Use them to protect behaviors that must not regress.

Negative findings should identify the smallest failing decision:

  • wrong trigger behavior
  • missing source type
  • skipped reference file
  • overloaded or hidden instruction
  • weak output contract
  • missing validation step
  • unsafe or non-portable path assumption

Each negative finding should map to a concrete skill delta or an explicit deferred reason.

Promotion Rules

Promote evidence into the skill artifacts only when it changes future behavior:

  • Put universal behavioral rules in SKILL.md.
  • Put domain-specific examples in a focused reference.
  • Put source provenance and decisions in SOURCES.md.
  • Keep raw or semi-raw examples in references/evidence/.

Do not turn references/evidence/ into a changelog. The changelog belongs in SOURCES.md.