mirror of
https://github.com/sentimony/skills.git
synced 2026-09-19 07:12:05 +08:00
3079952b01ac8fa16eb3582476176cc385d1abe4
Add a Development Workflow section to README.md that names scope-triage as the entry point, diagrams the main flow and the failure path in Mermaid, and lists the composability properties and conditional capabilities. Regroup the skill table to match the registries and move the install block above it. Consolidate skills.sh.json and .claude-plugin/marketplace.json from sixteen groups to ten, replacing the single-skill groups the workflow chain created. Every published skill still appears exactly once in each registry, and plugin name values are preserved as install identity. Bump scope-triage to 1.0.4: Route A now names tdd and debugging as backticked skill references instead of bare words, so the handoff into implementation is unambiguous. Routing semantics are unchanged. Ignore .sdd/ so subagent-plan-dev state does not surface in release diffs.
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.0 | v1.32.0 | 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.2 | v1.33.1 | 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.0 | v1.33.0 | 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%