Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 0 additions & 6 deletions .claude/settings.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@
"WebFetch(domain:docs.github.com)",
"WebFetch(domain:cli.github.com)",
"WebFetch(domain:agentskills.io)",

"Bash(ls:*)",
"Bash(pwd:*)",
"Bash(find:*)",
Expand All @@ -19,7 +18,6 @@
"Bash(tail:*)",
"Bash(cat:*)",
"Bash(tree:*)",

"Bash(git status:*)",
"Bash(git log:*)",
"Bash(git diff:*)",
Expand All @@ -29,7 +27,6 @@
"Bash(git tag:*)",
"Bash(git stash list:*)",
"Bash(git rev-parse:*)",

"Bash(gh pr view:*)",
"Bash(gh pr list:*)",
"Bash(gh pr checks:*)",
Expand All @@ -41,7 +38,6 @@
"Bash(gh run logs:*)",
"Bash(gh repo view:*)",
"Bash(gh api:*)",

"Skill(sentry-skills:agents-md)",
"Skill(sentry-skills:blog-writing-guide)",
"Skill(sentry-skills:brand-guidelines)",
Expand All @@ -50,7 +46,6 @@
"Skill(sentry-skills:code-simplifier)",
"Skill(sentry-skills:commit)",
"Skill(sentry-skills:create-branch)",
"Skill(sentry-skills:create-pr)",
"Skill(sentry-skills:django-access-review)",
"Skill(sentry-skills:django-perf-review)",
"Skill(sentry-skills:doc-coauthoring)",
Expand All @@ -60,7 +55,6 @@
"Skill(sentry-skills:iterate-pr)",
"Skill(sentry-skills:pr-writer)",
"Skill(sentry-skills:security-review)",
"Skill(sentry-skills:skill-creator)",
"Skill(sentry-skills:skill-scanner)",
"Skill(sentry-skills:skill-writer)",
"Skill(sentry-skills:sred-project-organizer)",
Expand Down
8 changes: 3 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,10 @@ 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.)
ALWAYS use `/skill-writer` — it handles requirements, writing, registration, and validation.

### Alias Policy
- Keep alias skills (for example `create-pr`, `skill-creator`) only for backward compatibility.
- Do **not** list alias/symlink skills in "Available Skills" documentation tables.
- List only canonical skills in public skill inventories (for example `pr-writer`, `skill-writer`).
- Do **not** create alias or symlink skills
- List only canonical skills in public skill inventories (for example `pr-writer`, `skill-writer`)

### Registration Checklist
1. Create `plugins/sentry-skills/skills/<skill-name>/SKILL.md`
Expand Down
2 changes: 0 additions & 2 deletions plugins/sentry-skills/skills/claude-settings-audit/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,6 @@ If this is a Sentry project (or sentry-skills plugin is installed), include:
"Skill(sentry-skills:code-simplifier)",
"Skill(sentry-skills:commit)",
"Skill(sentry-skills:create-branch)",
"Skill(sentry-skills:create-pr)",
"Skill(sentry-skills:django-access-review)",
"Skill(sentry-skills:django-perf-review)",
"Skill(sentry-skills:doc-coauthoring)",
Expand All @@ -160,7 +159,6 @@ If this is a Sentry project (or sentry-skills plugin is installed), include:
"Skill(sentry-skills:iterate-pr)",
"Skill(sentry-skills:pr-writer)",
"Skill(sentry-skills:security-review)",
"Skill(sentry-skills:skill-creator)",
"Skill(sentry-skills:skill-scanner)",
"Skill(sentry-skills:skill-writer)",
"Skill(sentry-skills:sred-project-organizer)",
Expand Down
12 changes: 0 additions & 12 deletions plugins/sentry-skills/skills/create-pr/SKILL.md

This file was deleted.

12 changes: 0 additions & 12 deletions plugins/sentry-skills/skills/skill-creator/SKILL.md

This file was deleted.

4 changes: 0 additions & 4 deletions plugins/sentry-skills/skills/skill-writer/SOURCES.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,12 @@ This file tracks source material synthesized into `skill-writer`, plus iterative
|---|---|---|---|---|---|---|---|
| `plugins/sentry-skills/skills/skill-writer/SKILL.md` | local canonical | canonical | 2026-03-05 | high | Baseline orchestration, path model, quality gates | local repository authority | Primary source of current behavior |
| `plugins/sentry-skills/skills/skill-writer/references/*.md` | local canonical | canonical | 2026-03-05 | high | Detailed path guidance, examples, validation requirements | local repository authority | Includes synthesis/iteration/evaluation paths |
| `plugins/sentry-skills/skills/skill-creator/SKILL.md` | local compatibility alias | canonical | 2026-03-05 | high | Backward-compatible invocation behavior | local repository authority | Confirms alias delegates to `skill-writer` |
| `.codex/skills/.system/skill-creator/SKILL.md` | local Codex upstream | secondary | 2026-03-05 | medium | Codex-native skill authoring conventions and structure | environment-local snapshot; may diverge from upstream | Used to align cross-agent portability expectations |
| `https://github.com/anthropics/skills/tree/main/skills/skill-creator` | external Claude upstream | canonical | 2026-03-05 | medium | Claude-native prior art and updated guidance | verify periodically against upstream changes | Track for periodic refresh as upstream evolves |
| `https://agentskills.io/specification` | external canonical spec | canonical | 2026-03-05 | high | Portable skill spec requirements | spec-level constraints take precedence over local preferences | Cross-agent compatibility baseline |
| `AGENTS.md` | repo convention | canonical | 2026-03-05 | high | Repository-specific workflow requirements | repository-local policy | Registration + validator expectations |
| `README.md` | repo convention | canonical | 2026-03-05 | high | Skill table format and authoring conventions | repository-local policy | Registration and discoverability source |

## Decisions

1. `skill-writer` is the single canonical workflow; `skill-creator` remains alias-only for compatibility.
2. Source breadth is the primary quality lever; synthesis cannot stop early on limited samples.
3. Provenance is stored in `SOURCES.md`, not SKILL header comments.
4. Case-study style examples are required for deeper, reusable synthesis outcomes.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,6 @@ Keep collecting until retrieval passes no longer add meaningful new guidance.
When synthesizing a skill that creates, updates, or evaluates other skills, include at minimum:

1. Local canonical workflow source (`plugins/sentry-skills/skills/skill-writer/...`).
2. Local compatibility alias/source (`plugins/sentry-skills/skills/skill-creator/SKILL.md`).
3. Codex system skill-authoring source (for example `.codex/skills/.system/skill-creator/SKILL.md` when available).
4. Anthropic/Claude upstream skill-authoring source (for example `anthropics/skills/.../skill-creator` or the published GitHub path).
5. Agent Skills specification and repository conventions.

Record all baseline sources in `SOURCES.md` with retrieval date and contribution notes.
Expand Down
Loading