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

Files

T

David Cramer 99623274f6 docs: Add contributor guidelines

Establish contribution philosophy emphasizing incremental change and
self-review as the default workflow. Include instructions for testing
skills locally and a checklist for adding new skills.

Co-Authored-By: Claude <noreply@anthropic.com>

2026-01-10 11:02:46 -08:00

1.8 KiB

Raw Permalink Blame History

Contributing

Philosophy

This repository favors incremental change over perfection. Skills are living documents that improve over time through small, iterative updates.

Bias toward action - Ship small improvements rather than waiting for the perfect solution
Self-review is the default - You know your changes best
Iterate freely - Don't hesitate to refine existing skills

Testing Skills

Before merging, test your changes locally:

Install the plugin from your local clone

claude plugin marketplace add ~/path/to/sentry-skills
claude plugin install sentry-skills

Restart Claude Code to pick up changes

Invoke the skill in a relevant context

# For explicit invocation
/skill-name

# Or describe a task that should trigger the skill

Verify behavior - Check that the skill produces the expected guidance and handles edge cases appropriately

Pull Request Workflow

All changes go through the PR flow, but formal review is optional.

Self-review and merge when you're confident in your change
Request review only when you want a second pair of eyes
Keep PRs focused - one skill or one improvement per PR when practical

Adding a New Skill

Create plugins/sentry-skills/skills/<skill-name>/SKILL.md

Add required YAML frontmatter:

---
name: skill-name
description: What this skill does. Include trigger keywords.
---

Update README.md to add the skill to the Available Skills table
Add the skill to .claude/settings.json:
```
"Skill(sentry-skills:skill-name)"
```
Update the skills allowlist in plugins/sentry-skills/skills/claude-settings-audit/SKILL.md

See README.md for the full skill template and optional frontmatter fields.