Ihor Orlovskyi 3079952b01 Document the development workflow and consolidate registry groups (#58)
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.
2026-09-13 18:18:07 +03:00
2026-07-05 21:21:01 +03:00

Agent Skills

skills.sh

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.

  • tdd is 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-request is invoked when the change warrants independent eyes, and review-resolution validates findings before anything is changed in response. A review verdict stands separate from completion: verification-gate owns the authoritative pass or fail against the current tree.
  • The diagnostic path has three distinct owners. debugging owns causal investigation, web-debug supplies browser and runtime evidence when the symptom lives in a page, and tdd drives 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-triage is reached on a condition. Route A terminates in implementation with proportional verification, and branch-finish runs 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 ;)

S
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%