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

Files

T

David Cramer 24361e7958 ref(skills): Load sentry-skills plugin from repo root (#117 )

Make repo-root `skills/` and `agents/` the canonical source for the
`sentry-skills` plugin by loading the plugin from repo root instead of
from `plugins/sentry-skills`.

The earlier refactor moved the tree to top level, but leaving a
plugin-local `skills` symlink still created a loader risk for
marketplace installs. This removes that dependency entirely: the
marketplace entry now points at `./`, the root plugin manifest uses
repo-root `skills/` and `agents/`, and the old plugin-local `skills`
path goes away.

This pass also tightens the repo guidance around standard skill
locations. `skill-writer` goes back to using `.agents/skills` as its
default local target, `skill-writer` and `skill-scanner` now explicitly
recognize canonical `skills/<name>/` roots, and the repo docs and
registrations are updated to match the new layout, including
`presentation-creator`.

I validated the change with strict-depth validation for `skill-writer`
and `skill-scanner`, plus a local Claude marketplace add/install smoke
test that produced real `skills/` and `agents/` directories in the
installed plugin cache without any plugin-local `skills` symlink.

---------

Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: Codex <codex@openai.com>

2026-04-19 16:10:08 -07:00

1.6 KiB

Raw Permalink Blame History

Agent Instructions

Skill Structure

skills/<skill-name>/SKILL.md

If you use Claude marketplace sparse checkouts for this repo, include skills and agents alongside .claude-plugin because the root plugin manifest loads repo-root skills/ and agents/.

Creating/Updating Skills

ALWAYS use /skill-writer — it handles requirements, writing, registration, and validation.

Do not create per-skill alias or symlink skills
The repo-level .agents/skills path is a convenience mirror of canonical skills/
List only canonical skills in public skill inventories (for example pr-writer, skill-writer)

Registration Checklist

Create skills/<skill-name>/SKILL.md
Add to README.md Available Skills table (alphabetical by canonical skill name; exclude aliases/symlinks)
Add to .claude/settings.json: Skill(sentry-skills:<skill-name>)
Add to allowlist in 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's name and attribution byline)

References

Skill template and optional fields: README.md
Testing and PR workflow: CONTRIBUTING.md
Agent Skills Spec

1.6 KiB Raw Permalink Blame History