Updated 4d ago
by etr
groundwork
Claude Code plugin with 30+ skills for structured development workflows
44 GitHub stars (44)
+1 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | 0 |
| Oct 3 | 0 |
| Oct 4 | 0 |
| Oct 5 | 0 |
| Oct 6 | 0 |
| Oct 7 | 0 |
| Oct 8 | 0 |
| Oct 9 | +1 |
| Oct 10 | 0 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 30 skills (30 skills found in its SKILL.md files)
- 5 forks (5 forks)
- 4d ago last update (Last updated 4d ago)
Install
Skills CLI
npx skills add etr/groundwork
Asks which skills and agents to install. Just one: npx skills add etr/groundwork --skill build-unplanned — add -g for every project.
Claude Code
git clone https://github.com/etr/groundworkcp -r "groundwork/skills/build-unplanned" ~/.claude/skills/
Copies the build-unplanned skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add etr/groundwork
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 30 of 42 files.
-
build-unplanned
Build a feature from description with worktree isolation and TDD. Usage /groundwork:build-unplanned "Add user login"
skills/build-unplanned/SKILL.md on GitHub (opens in a new tab) -
check-specs-alignment
Verify alignment between code and specs. Usage /groundwork:check-specs-alignment
skills/check-specs-alignment/SKILL.md on GitHub (opens in a new tab) -
create-tasks
Generate implementation tasks from architecture document. Usage /groundwork:create-tasks
skills/create-tasks/SKILL.md on GitHub (opens in a new tab) -
debug
This skill should be used when investigating bugs, unexpected behavior, test failures, or any code that does not work as expected - enforces systematic root cause analysis before any fix
skills/debug/SKILL.md on GitHub (opens in a new tab) -
design-architecture
This skill should be used when the user asks to design system architecture, make architectural decisions, or translate PRD into technical design
skills/design-architecture/SKILL.md on GitHub (opens in a new tab) -
design-it-twice
Use before committing to a non-trivial module, service boundary, or public API - generate 2-3 divergent interface designs, compare them on depth/locality/seam, and recommend one
skills/design-it-twice/SKILL.md on GitHub (opens in a new tab) -
design-product
Create detailed product requirements document (PRD) for a feature. Usage /groundwork:design-product
skills/design-product/SKILL.md on GitHub (opens in a new tab) -
domain-modeling
Use when designing a product or feature and the project lacks shared, agreed terminology - builds and maintains a pure domain glossary so agents speak one language
skills/domain-modeling/SKILL.md on GitHub (opens in a new tab) -
doubt-driven-development
Use when building a high-stakes or hard-to-reverse change - schema/data migrations, auth, payments, public API surface, destructive operations, or concurrency - to adversarially refute the chosen approach BEFORE committing to it
skills/doubt-driven-development/SKILL.md on GitHub (opens in a new tab) -
finalize-task
Use when a task worktree has passed validation - manually commits, merges, and cleans up, or prepares runner-owned commits and publication
skills/finalize-task/SKILL.md on GitHub (opens in a new tab) -
groundwork-check
Validate the Groundwork plugin for common issues. Usage /groundwork:groundwork-check
skills/groundwork-check/SKILL.md on GitHub (opens in a new tab) -
groundwork-help
List all Groundwork skills with descriptions. Usage /groundwork:groundwork-help
skills/groundwork-help/SKILL.md on GitHub (opens in a new tab) -
handoff
Use when ending a session or passing work to another agent - produces a compact handoff document that transfers context, state, and next objective without copying source material
skills/handoff/SKILL.md on GitHub (opens in a new tab) -
implement-task
Dispatches a planned task/feature to the task-executor agent for worktree-isolated TDD implementation
skills/implement-task/SKILL.md on GitHub (opens in a new tab) -
instrument-observability
Instrument a change with structured logging, RED metrics, trace spans, and symptom-based alerts - use while building the change, not after an incident proves it was unobservable
skills/instrument-observability/SKILL.md on GitHub (opens in a new tab) -
just-do-it-swarming
Execute all remaining tasks using agent teams for context isolation. Each task runs in its own session. Usage /groundwork:just-do-it-swarming [--parallel]
skills/just-do-it-swarming/SKILL.md on GitHub (opens in a new tab) -
just-do-it
Execute all remaining tasks in sequence until completion. Usage /groundwork:just-do-it
skills/just-do-it/SKILL.md on GitHub (opens in a new tab) -
plan-task
Plans a task or feature - loads context, optionally clarifies requirements, spawns Plan agent, persists plan to the project-scoped .groundwork-plans/
skills/plan-task/SKILL.md on GitHub (opens in a new tab) -
review-pr
Review a GitHub PR using multi-agent verification. Usage /groundwork:review-pr [PR number or URL]. Pass --no-interactive to skip all prompts and auto-publish.
skills/review-pr/SKILL.md on GitHub (opens in a new tab) -
select-project
This skill should be used when the user wants to switch between projects in a monorepo - lists projects from .groundwork.yml and sets the active project
skills/select-project/SKILL.md on GitHub (opens in a new tab) -
setup-repo
This skill should be used when configuring a repository for groundwork - detects single-project or monorepo structure and creates .groundwork.yml
skills/setup-repo/SKILL.md on GitHub (opens in a new tab) -
ship
Ship a validated change to production - sequences observability and a staged rollout, then gates the outward-facing deploy behind a final go/no-go. Usage /groundwork:ship
skills/ship/SKILL.md on GitHub (opens in a new tab) -
skills
List all available Groundwork skills with descriptions. Usage /groundwork:skills
skills/skills/SKILL.md on GitHub (opens in a new tab) -
source-architecture-from-code
Synchronize architecture document with codebase changes. Usage /groundwork:source-architecture-from-code
skills/source-architecture-from-code/SKILL.md on GitHub (opens in a new tab) -
source-product-specs-from-code
Synchronize PRD with implemented codebase changes. Usage /groundwork:source-product-specs-from-code
skills/source-product-specs-from-code/SKILL.md on GitHub (opens in a new tab) -
source-ux-design-from-code
Synchronize design system document with codebase changes. Usage /groundwork:source-ux-design-from-code
skills/source-ux-design-from-code/SKILL.md on GitHub (opens in a new tab) -
split-architecture
This skill should be used when converting a single-file architecture doc to directory-based format for better organization of large architecture documents
skills/split-architecture/SKILL.md on GitHub (opens in a new tab) -
split-specs
This skill should be used when converting a single-file spec to directory-based format for better organization of large specifications
skills/split-specs/SKILL.md on GitHub (opens in a new tab) -
staged-rollout
Roll out a change in stages behind a feature flag with a monitoring window and a written rollback plan - use before shipping anything user-facing, instead of flipping it on for everyone at once
skills/staged-rollout/SKILL.md on GitHub (opens in a new tab) -
statusline
Use when installing or uninstalling Groundwork's optional statusline configuration
skills/statusline/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.