mirror of
https://github.com/obra/superpowers.git
synced 2026-04-25 02:59:05 +08:00
Compare commits
7 Commits
drew/subag
...
drew/codex
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
458269ac94 | ||
|
|
a6f6c57753 | ||
|
|
cb8d0a4efa | ||
|
|
f81d5b45bb | ||
|
|
bbe64d4a3b | ||
|
|
37ecd67afa | ||
|
|
f014bb0775 |
@@ -17,8 +17,6 @@ Task tool (superpowers:code-reviewer):
|
|||||||
DESCRIPTION: [task summary]
|
DESCRIPTION: [task summary]
|
||||||
```
|
```
|
||||||
|
|
||||||
**If the project has a CLAUDE.md (or AGENTS.md), read it — use its conventions as review criteria.**
|
|
||||||
|
|
||||||
**In addition to standard code quality concerns, the reviewer should check:**
|
**In addition to standard code quality concerns, the reviewer should check:**
|
||||||
- Does each file have one clear responsibility with a well-defined interface?
|
- Does each file have one clear responsibility with a well-defined interface?
|
||||||
- Are units decomposed so they can be understood and tested independently?
|
- Are units decomposed so they can be understood and tested independently?
|
||||||
|
|||||||
@@ -18,8 +18,6 @@ Task tool (general-purpose):
|
|||||||
|
|
||||||
## Before You Begin
|
## Before You Begin
|
||||||
|
|
||||||
Read CLAUDE.md (or AGENTS.md) in the project root if it exists — its conventions are binding on your work.
|
|
||||||
|
|
||||||
If you have questions about:
|
If you have questions about:
|
||||||
- The requirements or acceptance criteria
|
- The requirements or acceptance criteria
|
||||||
- The approach or implementation strategy
|
- The approach or implementation strategy
|
||||||
|
|||||||
@@ -36,8 +36,6 @@ Task tool (general-purpose):
|
|||||||
|
|
||||||
## Your Job
|
## Your Job
|
||||||
|
|
||||||
If the project has a CLAUDE.md (or AGENTS.md), read it — verify the implementation follows its conventions.
|
|
||||||
|
|
||||||
Read the implementation code and verify:
|
Read the implementation code and verify:
|
||||||
|
|
||||||
**Missing requirements:**
|
**Missing requirements:**
|
||||||
|
|||||||
@@ -93,7 +93,7 @@ skills/
|
|||||||
## SKILL.md Structure
|
## SKILL.md Structure
|
||||||
|
|
||||||
**Frontmatter (YAML):**
|
**Frontmatter (YAML):**
|
||||||
- Two required fields: `name` and `description` (see [agentskills.io/specification](https://agentskills.io/specification) for all supported fields)
|
- Only two fields supported: `name` and `description`
|
||||||
- Max 1024 characters total
|
- Max 1024 characters total
|
||||||
- `name`: Use letters, numbers, and hyphens only (no parentheses, special chars)
|
- `name`: Use letters, numbers, and hyphens only (no parentheses, special chars)
|
||||||
- `description`: Third-person, describes ONLY when to use (NOT what it does)
|
- `description`: Third-person, describes ONLY when to use (NOT what it does)
|
||||||
@@ -604,7 +604,7 @@ Deploying untested skills = deploying untested code. It's a violation of quality
|
|||||||
|
|
||||||
**GREEN Phase - Write Minimal Skill:**
|
**GREEN Phase - Write Minimal Skill:**
|
||||||
- [ ] Name uses only letters, numbers, hyphens (no parentheses/special chars)
|
- [ ] Name uses only letters, numbers, hyphens (no parentheses/special chars)
|
||||||
- [ ] YAML frontmatter with required `name` and `description` fields (max 1024 chars; see [spec](https://agentskills.io/specification))
|
- [ ] YAML frontmatter with only name and description (max 1024 chars)
|
||||||
- [ ] Description starts with "Use when..." and includes specific triggers/symptoms
|
- [ ] Description starts with "Use when..." and includes specific triggers/symptoms
|
||||||
- [ ] Description written in third person
|
- [ ] Description written in third person
|
||||||
- [ ] Keywords throughout for search (errors, symptoms, tools)
|
- [ ] Keywords throughout for search (errors, symptoms, tools)
|
||||||
|
|||||||
@@ -144,7 +144,7 @@ What works perfectly for Opus might need more detail for Haiku. If you plan to u
|
|||||||
## Skill structure
|
## Skill structure
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
**YAML Frontmatter**: The SKILL.md frontmatter requires two fields:
|
**YAML Frontmatter**: The SKILL.md frontmatter supports two fields:
|
||||||
|
|
||||||
* `name` - Human-readable name of the Skill (64 characters maximum)
|
* `name` - Human-readable name of the Skill (64 characters maximum)
|
||||||
* `description` - One-line description of what the Skill does and when to use it (1024 characters maximum)
|
* `description` - One-line description of what the Skill does and when to use it (1024 characters maximum)
|
||||||
@@ -1092,7 +1092,7 @@ reader = PdfReader("file.pdf")
|
|||||||
|
|
||||||
### YAML frontmatter requirements
|
### YAML frontmatter requirements
|
||||||
|
|
||||||
The SKILL.md frontmatter requires `name` (64 characters max) and `description` (1024 characters max) fields. See the [Skills overview](/en/docs/agents-and-tools/agent-skills/overview#skill-structure) for complete structure details.
|
The SKILL.md frontmatter includes only `name` (64 characters max) and `description` (1024 characters max) fields. See the [Skills overview](/en/docs/agents-and-tools/agent-skills/overview#skill-structure) for complete structure details.
|
||||||
|
|
||||||
### Token budgets
|
### Token budgets
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user