mirror of
https://github.com/sentimony/skills.git
synced 2026-09-19 07:12:05 +08:00
736c5b79dbf44ac9629bf9784f322da2672f93a8
plan-crafting and tdd were the only two forks of obra/superpowers whose LICENSE lacked the fork maintainer line alongside the upstream notice. Both files are now byte-identical to the other ten forks; the upstream copyright is preserved. Bump plan-crafting to 1.3.1 and tdd to 1.0.3 as patch releases: the change is non-behavioral, leaving triggers, descriptions and responsibilities untouched.
Agent Skills
A collection of agent skills for Claude Code, Codex and other AI coding agents.
Install
# All at once
npx skills add sentimony/skills -a codex claude-code -y
# Or each separately
npx skills add sentimony/skills -s scope-triage -a codex claude-code -y
npx skills add sentimony/skills -s plan-crafting -a codex claude-code -y
npx skills add sentimony/skills -s inline-plan-dev -a codex claude-code -y
npx skills add sentimony/skills -s subagent-plan-dev -a codex claude-code -y
npx skills add sentimony/skills -s tdd -a codex claude-code -y
npx skills add sentimony/skills -s debugging -a codex claude-code -y
npx skills add sentimony/skills -s web-debug -a codex claude-code -y
npx skills add sentimony/skills -s review-request -a codex claude-code -y
npx skills add sentimony/skills -s review-resolution -a codex claude-code -y
npx skills add sentimony/skills -s verification-gate -a codex claude-code -y
npx skills add sentimony/skills -s branch-finish -a codex claude-code -y
npx skills add sentimony/skills -s workspace-isolation -a codex claude-code -y
npx skills add sentimony/skills -s parallel-agents -a codex claude-code -y
npx skills add sentimony/skills -s frontend-crafting -a codex claude-code -y
npx skills add sentimony/skills -s echarts -a codex claude-code -y
npx skills add sentimony/skills -s typescript -a codex claude-code -y
npx skills add sentimony/skills -s vitest -a codex claude-code -y
npx skills add sentimony/skills -s maintaining-agent-context -a codex claude-code -y
npx skills add sentimony/skills -s commit-all -a codex claude-code -y
npx skills add sentimony/skills -s dashfix -a codex claude-code -y
npx skills add sentimony/skills -s negafix -a codex claude-code -y
Development Workflow
scope-triage is the development entry point. It classifies the request and picks the
minimum appropriate process, so a one-line configuration change and a new subsystem do not
receive the same ceremony.
flowchart TD
S[scope-triage] --> R{Route}
R -->|A: Direct| D[Direct implementation]
R -->|B: Light spec| L[Light spec]
L --> D
R -->|C: Full design| F[Approved design]
F --> P[plan-crafting]
P --> E{Execution mode}
E --> I[inline-plan-dev]
E --> SA[subagent-plan-dev]
D -. behavior changes .-> T[tdd]
I -. behavior changes .-> T
SA -. behavior changes .-> T
D --> Q{Review warranted?}
I --> Q
SA --> Q
Q -->|Yes| RR[review-request]
RR --> RF{Findings?}
RF -->|Yes| RES[review-resolution]
RF -->|No| V[verification-gate]
RES --> V
Q -->|No| V
V -->|PASS| B{Branch/workspace lifecycle?}
B -->|Yes| BF[branch-finish]
B -->|No| DONE[Complete]
BF --> DONE
When work fails unexpectedly, the diagnostic path runs alongside the main flow and returns to whatever workflow discovered the failure.
flowchart TD
F[Unexpected failure / bug / regression] --> D[debugging]
D --> W{Browser evidence needed?}
W -->|Yes| WD[web-debug]
WD --> D
W -->|No or evidence sufficient| RC{Root cause established?}
RC -->|No| D
RC -->|Yes| B{Behavior correction?}
B -->|Yes| T[tdd]
B -->|No| FIX[Root-cause fix]
T --> FIX
FIX --> RET[Return to calling workflow]
D -. material redesign required .-> S[scope-triage]
Four properties of this workflow are worth stating explicitly.
tddis used within implementation, whenever behavior changes. It is a micro-cycle inside a task rather than a sequential phase that follows implementation. Both execution modes and direct implementation invoke it at the moment a behavior change is written.- Review is proportional; verification is authoritative.
review-requestis invoked when the change warrants independent eyes, andreview-resolutionvalidates findings before anything is changed in response. A review verdict stands separate from completion:verification-gateowns the authoritative pass or fail against the current tree. - The diagnostic path has three distinct owners.
debuggingowns causal investigation,web-debugsupplies browser and runtime evidence when the symptom lives in a page, andtdddrives the regression behavior once the cause is known. The fix then returns to the workflow that discovered the failure. - The workflow is composable rather than mandatory-linear. Every step after
scope-triageis reached on a condition. Route A terminates in implementation with proportional verification, andbranch-finishruns only when a branch or workspace lifecycle exists.
Conditional capabilities, invoked when the work calls for them rather than in sequence:
tdd, debugging, web-debug, workspace-isolation, parallel-agents,
frontend-crafting, vitest, typescript, echarts.
Skills
Design & Planning
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| scope-triage | 1.0.4 | v1.34.0 | Classify request scope before design work, then route to direct implementation, a light spec, or a full design cycle. |
| plan-crafting | 1.3.1 | v1.34.2 | Turn an approved design or settled requirements into a bite-sized, TDD-oriented implementation plan. |
Execution
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| inline-plan-dev | 1.0.0 | v1.32.0 | Execute an existing implementation plan inline in the current session, with plan-reality reconciliation, proportional verification, and durable resume. |
| subagent-plan-dev | 1.0.0 | v1.32.0 | Execute an existing implementation plan through scoped subagents with risk-based dispatch, independent verification, and controlled escalation. |
| tdd | 1.0.3 | v1.34.2 | Drive behavior changes through valid RED, sufficient GREEN, and evidence-backed refactoring. |
Debugging
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| debugging | 1.0.6 | v1.33.1 | Investigate bugs and unexpected technical behavior with a root-cause-first evidence workflow. |
| web-debug | 1.3.3 | v1.26.0 | Debug and verify local web apps via Playwright. |
Review & Verification
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| review-request | 1.0.0 | v1.27.0 | Prepare and dispatch independent code review against requirements, exact scope, and the actual diff. |
| review-resolution | 1.0.0 | v1.28.0 | Validate and resolve code-review findings with evidence, explicit dispositions, and proportional re-review decisions. |
| verification-gate | 1.0.0 | v1.29.0 | Turn a completion claim into an evidence-backed verdict against the current tree. |
Completion & Workspace
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| branch-finish | 1.0.1 | v1.34.1 | Decide, execute and report the integration outcome for verified work, cleaning up only what is provably safe to remove. |
| workspace-isolation | 1.0.0 | v1.30.0 | Select, detect, or create a safe isolated development workspace with explicit ownership, baseline, and handoff. |
| parallel-agents | 1.0.0 | v1.31.0 | Prove work units independent, isolate mutable state, and dispatch one bounded parallel wave with reconciled results. |
Frontend
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| frontend-crafting | 1.3.0 | v1.23.0 | Create, redesign, review, and polish user interfaces with subject-driven design decisions and a verifiable quality gate. |
| echarts | 1.2.0 | v1.22.0 | Build, audit, style, debug, and optimize Apache ECharts visualizations in vanilla JS, React, or Vue. |
TypeScript & Testing
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| typescript | 1.4.0 | v1.20.0 | Configure tsconfig, diagnose compiler behavior, and audit or migrate TypeScript projects. |
| vitest | 1.3.0 | v1.21.0 | Configure, write, debug, run, migrate, and audit Vitest tests for JavaScript/TypeScript projects. |
Agent Context
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| maintaining-agent-context | 1.3.0 | v1.24.0 | Audit, restructure, and maintain a repository's agent instruction architecture for Claude Code and Codex. |
Git Workflow
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| commit-all | 1.1.0 | v1.16.0 | Gather the working tree into a single commit on the current branch, on explicit /commit-all invocation only. |
Writing Style
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| dashfix | 1.2.1 | v1.12.1 | Ban typographic dashes in English text, check their form where a language's orthography requires them, audit a project, and score it 0-100. |
| negafix | 1.2.1 | v1.12.1 | Ban negative parallelism ("it's not just X, it's Y"), audit prose for it, and score it 0-100. |
Have fun ;)
Description
echarts: You MUST use this when building, styling, debugging, or optimizing Apache ECharts charts in JavaScript, React, or Vue - setup, lifecycle, responsive resizing,…; web-debug: You MUST use this when interacting with or testing local web applications with Playwright - verifying frontend functionality, debugging UI behavior, capturing…; typescript: You MUST use this when configuring tsconfig, resolving compiler errors, debugging slow type-checking, fixing module resolution or ESM/CJS issues,…
Readme
1.1 MiB
Languages
Python
98.2%
Shell
0.6%
TypeScript
0.5%
HTML
0.4%
Vue
0.3%