mirror of
https://github.com/sentimony/skills.git
synced 2026-09-19 07:12:05 +08:00
99067ef6a54a6469f904d075583e49ca0716b1cd
The name now says which mechanism the workflow reaches for most often. Nothing about the selection hierarchy changes: section 4 still ranks reusing existing safe isolation first, a harness-native workspace second, a manual Git worktree third, and safe work in place remains a legitimate outcome. The paragraph that introduces the skill says so against the stronger name, so a run ending without a worktree still reads as complete. Eight referencing skills follow the rename, both registries move with the directory, and the frozen changelog entries from v1.35.0 keep the previous name as the historical record.
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 git-worktree-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, git-worktree-isolation, parallel-agents,
frontend-crafting, vitest, typescript, echarts.
Skills
Design & Planning
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| scope-triage | 1.0.5 | 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.3 | 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.3 | 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.3 | v1.32.0 | Execute an existing implementation plan through scoped subagents with risk-based dispatch, independent verification, and controlled escalation. |
| tdd | 1.0.4 | v1.34.2 | Drive behavior changes through valid RED, sufficient GREEN, and evidence-backed refactoring. |
Debugging
| Skill | Skill Version | Release | Description |
|---|---|---|---|
| debugging | 1.0.9 | 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.3 | v1.27.0 | Prepare and dispatch independent code review against requirements, exact scope, and the actual diff. |
| review-resolution | 1.0.3 | v1.28.0 | Validate and resolve code-review findings with evidence, explicit dispositions, and proportional re-review decisions. |
| verification-gate | 1.0.3 | 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.4 | v1.34.1 | Decide, execute and report the integration outcome for verified work, cleaning up only what is provably safe to remove. |
| git-worktree-isolation | 1.2.0 | v1.30.0 | Select, detect, or create a safe isolated development workspace with explicit ownership, baseline, and handoff. |
| parallel-agents | 1.0.3 | 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.1 | v1.23.0 | Create, redesign, review, and polish user interfaces with subject-driven design decisions and a verifiable quality gate. |
| echarts | 1.2.1 | 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.1 | v1.20.0 | Configure tsconfig, diagnose compiler behavior, and audit or migrate TypeScript projects. |
| vitest | 1.3.1 | 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.1 | 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.1 | 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.2 | 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.2 | 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%