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/registration-validation.md

Registration and Validation

Apply registration and lightweight validation before completion.

Registration checklist

  1. Inspect the workspace and identify the active skill layout before editing files.
  2. Create/update <skill-root>/SKILL.md, <skill-root>/SPEC.md when required by change scope, and any bundled references/, scripts/, or assets/ beneath that root.
  3. Default to .agents/skills/<name>/ when there is no stronger prior art.
  4. If the workspace clearly uses a different canonical layout, follow that layout instead of forcing .agents/skills/.
  5. Common established alternatives include:
    • skills/<name>/ when the workspace uses a canonical root skill tree
    • .claude/skills/<name>/ for project-scoped Claude skills
    • plugins/<plugin>/skills/<name>/ for plugin-scoped skills
    • another repository-managed skill root that is already established by neighboring skills or docs
  6. If multiple plausible locations exist and inspection does not make the canonical target clear, ask the user before editing files.
  7. Only apply repository-specific registration steps when the workspace conventions explicitly require them.

When a repository does maintain its own skill catalog, verify and update any required registration files such as:

  • public skill inventories or tables
  • project or plugin settings files
  • allowlists used by other skills or automation

Validation checklist

The validator is a structural check. It should fail only for invalid skill format or missing referenced files. The size warning requires author judgment, not a machine gate.

  1. Run:
uv run scripts/quick_validate.py <path/to/skill-directory>

Use the skill-root-relative form above when running from the skill-writer directory. If you must run the validator from another working directory, convert both paths to the correct relative path from that directory instead of introducing absolute or host-specific paths into the skill docs.

  1. Confirm manually for authoring/generator skills:
  • transformed examples exist in references (happy-path, secure/robust, anti-pattern+fix)
  • synthesis coverage was considered and any gaps are explicit
  • selected example profile requirements are satisfied and reported
  • SPEC.md exists or was updated when the change creates a skill or materially changes intent, scope, evidence model, validation, or maintenance expectations
  • every bundled reference file is directly discoverable from SKILL.md
  1. Confirm manually for integration/documentation skills:
  • focused references cover API surface, common use cases, known issues/workarounds, and version variance
  • reference file names fit the skill's domain rather than a fixed template
  • SKILL.md and references/*.md avoid host-specific absolute filesystem paths
  1. Confirm manually for skills that are expected to be portable by default:
  • bundled file references use skill-root-relative paths such as references/..., scripts/..., or assets/...
  • provider-specific path variables (for example ${CLAUDE_SKILL_ROOT}) should not be used; use skill-root-relative paths instead (e.g. scripts/foo.py, references/bar.md)
  • provider-specific behavior, if any, is labeled as compatibility guidance rather than the primary workflow
  1. Review validator warnings for oversized SKILL.md files.
  2. Do not add validators for skill class, coverage quality, SPEC shape, trigger quality, or other qualitative guidance.

Required output

  • Registration changes summary
  • Selected skill root and why it was chosen
  • Validator output
  • Any residual risks or open gaps