Skip to content

ultimatile/development-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

187 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

development-skills

End-to-end development workflow skills for Claude Code — from a GitHub issue to a merged PR.

Skills

Issue → Plan → Code

Skill Description
research Hypothesis-driven investigation under the four-state decision discipline (confirmed / rejected / inconclusive / deferred). Classifies hypotheses as empirical (subagent-verified) vs derivational (deduced in main context); posts the resulting plan to the issue body (umbrella-spawned sub-issue) or comment (single-scope issue). Depends on haru0416-dev/quaere (quaere-evidence, quaere-semantic)
codex-plan-review Review the implementation plan with Codex against the actual codebase before coding
implement Execute a plan via the quaere-execution discipline (Plan → Do → Study → Act) with drift surfacing and done-check before completion. Reads the plan from the sub-issue body (umbrella-spawned) or comments (single-scope). Depends on haru0416-dev/quaere (quaere-execution)
research-and-implement End-to-end wrapper that runs research (Phase 1) then implement (Phase 2), with a branch baseline gate up front. Depends on haru0416-dev/quaere (quaere-evidence + quaere-execution)

Issue & PR drafting

Skill Description
file-issue Draft and file a GitHub issue following formatting conventions (semantic line breaks, LaTeX math, no local references). Includes an umbrella sub-issue variant (Parent: linkage, Goal/Scope/Out of scope/Acceptance shape) used by research when spawning sub-issues from an umbrella
file-adr Draft an Architecture Decision Record (a timeless decision, distinct from an implementation schedule) and write the file under the project's ADR directory. Enforces classification against file-issue and a frozen-after-Acceptance discipline
file-pullreq Draft and file a GitHub PR following the PR body skeleton, routed through the gh-post wrapper. Supports a gate mode that stops at user approval before posting
gh-body-conventions Single source of truth for GitHub issue / PR body conventions — semantic line breaks, LaTeX-safe math, reference / exclusion policies, language defaults. Definition file referenced by the drafting and check skills, not a procedure
gh-body-check Audit a drafted or filed GitHub issue / PR body against gh-body-conventions via a fresh-context subagent; any unresolved ⚠ blocks the caller

Documentation

Skill Description
file-pubdoc Draft README.md or visitor-facing markdown (top-level *.md, docs/**/*.md) from the canonical skeleton, complementing the public-doc-durability audit

Code → Review → Ship

Skill Description
stage-commit-push Stage, generate conventional commit message, commit, and push
finding-triage Single source of truth for per-finding review-triage dispositions (actionable / false-positive / uncertain-validity / opens-a-question → research / invariant-premise-check / defer), referenced by the review and audit skills instead of each restating the taxonomy. Definition file, not a procedure
codex-review Run OpenAI Codex review with triage before PR creation
coderabbit-local-review Run a local CodeRabbit CLI review (no PR needed) with triage — second pre-PR reviewer alongside codex-review
copilot-review Create PR with GitHub Copilot review, poll for results, triage
coderabbit-review Create PR and wait for the auto-triggered CodeRabbit review, triage. Use when CodeRabbit is the repo's PR reviewer instead of Copilot
review-pipeline Orchestrator — runs the full flow from local changes to reviewed PR
review-pipeline-coderabbit review-pipeline variant with Phase 2 swapped from Copilot to CodeRabbit. Use when Copilot review is unavailable or the repo runs CodeRabbit

End-to-end composite

Skill Description
reimre Full end-to-end wrapper — runs research-and-implement then review-pipeline back to back, with an automatic seam rule that skips the duplicate done-check at the boundary. Stops at the user-controlled merge gate inherited from review-pipeline.
reimrecr reimre variant wrapping review-pipeline-coderabbit instead of review-pipeline. Use when Copilot review is unavailable or the repo runs CodeRabbit
land-via-integration-branch Land a large change too big for one PR as a sequence of PRs merging into a long-lived integration branch, under a four-gate cadence (per-commit done-check, per-unit codex review, per-PR-open codex review, per-PR-review Copilot); a final PR merges the branch into main via review-pipeline. Use when one PR would exceed a reviewer's diff-size limit or when multiple component APIs must migrate together.

Quality Gates

Skill Description
quality-list Single source of truth for universal code-quality items, referenced by done-check and todo-check
todo-check Preflight sweep of quality items before/during implementation
done-check Post-hoc audit of quality items before declaring a task complete or requesting external review

Post-Ship Hygiene

Skill Description
bug-to-contract Promote review findings and bug fixes into runtime contract tests
finding-to-audit Promote review findings into pre-commit audit rules that catch issues at diff-inspection time
gate-miss-to-issue Promote a late-caught defect — one an earlier gate should have caught — into a development-skills issue proposing a fix to that gate's procedure
review-telemetry Append a normalized per-run record of reviewer-gate performance to ~/.claude/review-telemetry/runs.jsonl after a pipeline run — accumulates the data for evaluating the reviewer mix
codex-contract-test-review Narrow Codex pass to verify a newly added contract test actually expresses the claimed contract
driftreaper Audit docstrings for drift against actual code behavior
breachreaper Audit existing code for stock-detectable API-contract breaches
debtreaper Audit an existing test suite for structural debt — trivializing fixtures, tautological differentials, implementation-locked or assertion-less tests, name-claim mismatches

Language-specific

Skill Description
languages/Rust/cargo-mutants Configure and run cargo-mutants for Rust mutation testing
languages/Rust/rust-ffi-rule Rules for implementing a Rust safe wrapper around an external (C / Fortran / FFI) call
languages/Cpp/stdlib-audit Audit C++ source for known-bad standard library defaults via a TSV-driven, extensible rule table

Install

development-skills

claude plugin marketplace add ultimatile/development-skills
claude plugin install development-skills

gh-post

The skills that draft or post GitHub issue / PR bodies (file-issue, file-pullreq, copilot-review, review-pipeline, research, implement, and their wrappers) route every body through the gh-post wrapper — a gh front-end that accepts bodies only via --body-file / --body-stdin and re-runs a hard-wrap validator before forwarding to gh. Install it and make sure gh-post is on PATH.

Quaere skills

research, implement, research-and-implement, and reimre require the upstream Quaere skills (quaere-evidence, quaere-execution, quaere-semantic) installed under ~/.claude/skills/:

npx quaere-cli install --target claude

Credits

The XML-block prompt structure used in codex-plan-review is inspired by the gpt-5-4-prompting skill from openai/codex-plugin-cc.

About

Personalized Development Skills

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages