G

Groundwork

Comprehensive skills library for Claude Code and Codex that structures discovery, planning, design, TDD, debugging, validation, collaboration, and shipping

etr/groundwork · v3.6.4 · Development & Workflow

etrOwner verifiedcaution
InstallSource
60Follow0

Trust Score

60

Security

59

Surfaces

42

What is Groundwork?

Groundwork is a published development & workflow plugin for AI coding agents in the claude-code ecosystem, developed by etr and distributed through the HOL AI plugin registry. Comprehensive skills library for Claude Code and Codex that structures discovery, planning, design, TDD, debugging, validation, collaboration, and shipping

Canonical slug
etr/groundwork
Version
v3.6.4 · updated Oct 8, 2026

Trust & Reputation

HOL Trust Score
60

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
64pts
Maintenance
55pts
MCP Posture
100pts
Plugin Security
59pts
Provenance
70pts
Publisher Quality
75pts

Registry Snapshot

Publisher verification
No
Marketplace source
Unknown
Scanner
Broker fallback
Safety label
caution
Digest verified
Yes
42 bundled skills — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score
60

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
64pts
Maintenance
55pts
MCP Posture
100pts
Plugin Security
59pts
Provenance
70pts
Publisher Quality
75pts

Provenance

Plugin root
.
Source repo
https://github.com/etr/groundwork
Source commit
13b9fe3201c8…
Publisher verified
No
Owner verified
@etr

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

Verified badge not detected

Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.

Security Posture

caution
Safety label
59
Security score
0
High findings
Provider
registry-broker-fallback
Grade
F · caution
Version
Unknown
cisco-skill-scanner: unknown

Findings

mediumpublishabilitypublishability.link.missing.websiteURL

websiteURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.privacyPolicyURL

privacyPolicyURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

lowoperational-securitysupply-chain.lockfile-missing

Repository snapshot does not include a lockfile.

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

Groundwork — Frequently asked questions

What is Groundwork?
Groundwork is an AI plugin in the HOL registry. Comprehensive skills library for Claude Code and Codex that structures discovery, planning, design, TDD, debugging, validation, collaboration, and shipping
How do I install Groundwork?
Install Groundwork in your harness: Claude Code — /plugin marketplace add etr/groundwork; Any agent — npx skills add etr/groundwork. Full step-by-step guidance is on the HOL plugin page.
How do I install Groundwork in Claude Code?
To install Groundwork in Claude Code, start with /plugin marketplace add etr/groundwork. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
Is Groundwork free?
Pricing for Groundwork is published on its HOL plugin page when the maker schedules a launch.
Who publishes Groundwork?
Groundwork is published by etr and listed on HOL.
Is Groundwork available now?
Groundwork availability is listed on its HOL plugin page.

Install Guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs
  1. 1

    Add the marketplace

    Run this inside a Claude Code session.

    claude code
  2. 2

    Install the plugin

    Use the plugin name and the marketplace name shown by the previous command.

    claude code
  3. 3

    Scripted alternative

    Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.

    shell

Plugin Manifest

{
  "name": "groundwork",
  "description": "Comprehensive skills library for Claude Code: planning, design, TDD, debugging, collaboration patterns, and proven techniques",
  "version": "3.6.4",
  "author": {
    "name": "Groundwork Contributors"
  },
  "license": "MIT",
  "keywords": [
    "skills",
    "planning",
    "design",
    "tdd",
    "debugging",
    "collaboration",
    "best-practices",
    "workflows"
  ],
  "homepage": "https://github.com/etr/groundwork",
  "repository": "https://github.com/etr/groundwork",
  "interface": {
    "displayName": "groundwork",
    "developerName": "etr"
  },
  "skills": "./",
  "holManifestOrigin": "repository",
  "registryIndexVersion": 5
}

Marketplace Source

Repo URL
https://github.com/etr/groundwork
Marketplace path
Unknown
Source path
.
Install policy
Unspecified

Skills

42 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli

  • build-unplanned

    skills/build-unplanned/SKILL.md

    Build a feature from description with worktree isolation and TDD. Usage /groundwork:build-unplanned "Add user login

    Raw SKILL.md

  • check-specs-alignment

    skills/check-specs-alignment/SKILL.md

    Verify alignment between code and specs. Usage /groundwork:check-specs-alignment

    Raw SKILL.md

  • create-tasks

    skills/create-tasks/SKILL.md

    Generate implementation tasks from architecture document. Usage /groundwork:create-tasks

    Raw SKILL.md

  • debug

    skills/debug/SKILL.md

    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

    Raw SKILL.md

  • design-architecture

    skills/design-architecture/SKILL.md

    This skill should be used when the user asks to design system architecture, make architectural decisions, or translate PRD into technical design

    Raw SKILL.md

  • design-it-twice

    skills/design-it-twice/SKILL.md

    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

    Raw SKILL.md

  • design-product

    skills/design-product/SKILL.md

    Create detailed product requirements document (PRD) for a feature. Usage /groundwork:design-product

    Raw SKILL.md

  • domain-modeling

    skills/domain-modeling/SKILL.md

    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

    Raw SKILL.md

  • doubt-driven-development

    skills/doubt-driven-development/SKILL.md

    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

    Raw SKILL.md

  • finalize-task

    skills/finalize-task/SKILL.md

    Use when a task worktree has passed validation - manually commits, merges, and cleans up, or prepares runner-owned commits and publication

    Raw SKILL.md

  • groundwork-check

    skills/groundwork-check/SKILL.md

    Validate the Groundwork plugin for common issues. Usage /groundwork:groundwork-check

    Raw SKILL.md

  • groundwork-help

    skills/groundwork-help/SKILL.md

    List all Groundwork skills with descriptions. Usage /groundwork:groundwork-help

    Raw SKILL.md

  • handoff

    skills/handoff/SKILL.md

    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

    Raw SKILL.md

  • implement-task

    skills/implement-task/SKILL.md

    Dispatches a planned task/feature to the task-executor agent for worktree-isolated TDD implementation

    Raw SKILL.md

  • instrument-observability

    skills/instrument-observability/SKILL.md

    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

    Raw SKILL.md

  • just-do-it-swarming

    skills/just-do-it-swarming/SKILL.md

    Execute all remaining tasks using agent teams for context isolation. Each task runs in its own session. Usage /groundwork:just-do-it-swarming [--parallel]

    Raw SKILL.md

  • just-do-it

    skills/just-do-it/SKILL.md

    Execute all remaining tasks in sequence until completion. Usage /groundwork:just-do-it

    Raw SKILL.md

  • plan-task

    skills/plan-task/SKILL.md

    Plans a task or feature - loads context, optionally clarifies requirements, spawns Plan agent, persists plan to the project-scoped .groundwork-plans/

    Raw SKILL.md

  • review-pr

    skills/review-pr/SKILL.md

    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.

    Raw SKILL.md

  • select-project

    skills/select-project/SKILL.md

    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

    Raw SKILL.md

  • setup-repo

    skills/setup-repo/SKILL.md

    This skill should be used when configuring a repository for groundwork - detects single-project or monorepo structure and creates .groundwork.yml

    Raw SKILL.md

  • ship

    skills/ship/SKILL.md

    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

    Raw SKILL.md

  • skills

    skills/skills/SKILL.md

    List all available Groundwork skills with descriptions. Usage /groundwork:skills

    Raw SKILL.md

  • source-architecture-from-code

    skills/source-architecture-from-code/SKILL.md

    Synchronize architecture document with codebase changes. Usage /groundwork:source-architecture-from-code

    Raw SKILL.md

  • source-product-specs-from-code

    skills/source-product-specs-from-code/SKILL.md

    Synchronize PRD with implemented codebase changes. Usage /groundwork:source-product-specs-from-code

    Raw SKILL.md

  • source-ux-design-from-code

    skills/source-ux-design-from-code/SKILL.md

    Synchronize design system document with codebase changes. Usage /groundwork:source-ux-design-from-code

    Raw SKILL.md

  • split-architecture

    skills/split-architecture/SKILL.md

    This skill should be used when converting a single-file architecture doc to directory-based format for better organization of large architecture documents

    Raw SKILL.md

  • split-specs

    skills/split-specs/SKILL.md

    This skill should be used when converting a single-file spec to directory-based format for better organization of large specifications

    Raw SKILL.md

  • staged-rollout

    skills/staged-rollout/SKILL.md

    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

    Raw SKILL.md

  • statusline

    skills/statusline/SKILL.md

    Use when installing or uninstalling Groundwork's optional statusline configuration

    Raw SKILL.md

  • swarm-debug

    skills/swarm-debug/SKILL.md

    Start swarm debugging with parallel hypothesis investigation. Usage /groundwork:swarm-debug [bug description]

    Raw SKILL.md

  • swarm-design-architecture

    skills/swarm-design-architecture/SKILL.md

    Design architecture using parallel advocate agents for adversarial technology comparison. Usage /groundwork:swarm-design-architecture

    Raw SKILL.md

  • task-validation-loop

    skills/task-validation-loop/SKILL.md

    This skill should be used when the task list is complete to run multi-agent verification ensuring tasks cover PRD, follow architecture, and respect design system

    Raw SKILL.md

  • test-driven-development

    skills/test-driven-development/SKILL.md

    This skill should be used when implementing any feature or bugfix, before writing implementation code

    Raw SKILL.md

  • understanding-feature-requests

    skills/understanding-feature-requests/SKILL.md

    This skill should be used when clarifying feature requests, gathering requirements, or checking for contradictions in proposed changes

    Raw SKILL.md

  • use-git-worktree

    skills/use-git-worktree/SKILL.md

    This skill should be used when starting feature work that needs isolation from current workspace - creates isolated git worktrees with smart directory selection and safety verification

    Raw SKILL.md

  • using-groundwork

    skills/using-groundwork/SKILL.md

    This skill should be used when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    Raw SKILL.md

  • ux-design

    skills/ux-design/SKILL.md

    Create design system with foundations, brand identity, and UX patterns. Usage /groundwork:ux-design

    Raw SKILL.md

  • validate

    skills/validate/SKILL.md

    This skill should be used when implementation is complete to run multi-agent verification with baseline-determined repair and causal closure review

    Raw SKILL.md

  • vertical-slice

    skills/vertical-slice/SKILL.md

    Use when building a feature large enough to span multiple layers - structure the work as thin, end-to-end, independently-shippable slices behind a feature flag instead of building layer-by-layer

    Raw SKILL.md

  • work-on-next-task

    skills/work-on-next-task/SKILL.md

    Execute next uncompleted task with full project context (PRD, architecture, tasks). Usage /groundwork:work-on-next-task

    Raw SKILL.md

  • work-on

    skills/work-on/SKILL.md

    skill to "execute a task", "work on task N", or "implement TASK-NNN" - orchestrates worktree isolation, TDD implementation, validation, and merge.

    Raw SKILL.md

File Inventory

.claude-plugin/plugin.json

file

492 bytes

e439573828f00b2c…

.codex-plugin/plugin.json

plugin-manifest

577 bytes

59bc9561e219b6ae…

AGENTS.md

file

12,114 bytes

2f00ecc5400d9658…

agents/architecture-alignment-checker/AGENT.md

file

7,616 bytes

cc1127dd7b0ffd97…

agents/architecture-task-alignment-checker/AGENT.md

file

6,120 bytes

9fe4baeac5b7ceb4…

agents/cloud-infrastructure-reviewer/AGENT.md

file

18,690 bytes

e745001a42f68e1b…

agents/code-quality-reviewer/AGENT.md

file

5,862 bytes

829b57ca5e2d73b1…

agents/code-simplifier/AGENT.md

file

7,069 bytes

e604c9c4d5279c99…

agents/conventions-reviewer/AGENT.md

file

7,625 bytes

ac21e12ebd4ef1b9…

agents/design-consistency-checker/AGENT.md

file

19,907 bytes

ad5276a1b59f931d…

agents/design-task-alignment-checker/AGENT.md

file

6,878 bytes

06b69282f43beab0…

agents/housekeeper/AGENT.md

file

8,481 bytes

66cd372f8757e3b4…

agents/performance-reviewer/AGENT.md

file

11,212 bytes

d4856ee811edd771…

agents/prd-architecture-checker/AGENT.md

file

6,992 bytes

b8e001fdeb122cac…

agents/prd-task-alignment-checker/AGENT.md

file

5,414 bytes

5c4628f37bcf7325…

agents/researcher/AGENT.md

file

8,212 bytes

ed2af0104b7a558d…

agents/security-reviewer/AGENT.md

file

6,799 bytes

28ad97355ab74516…

agents/spec-alignment-checker/AGENT.md

file

7,367 bytes

0ef38d95ac181f8c…

agents/task-executor/AGENT.md

file

7,157 bytes

51f20c577a3ace23…

agents/test-quality-reviewer/AGENT.md

file

8,210 bytes

edc55f9e02428455…

agents/validation-fixer/AGENT.md

file

6,957 bytes

db7fa41e63ec3045…

CLAUDE.md

file

12,096 bytes

366ba1aa2941ec18…

hooks/check-commit-alignment.sh

file

5,016 bytes

1c04bb89b344601c…

hooks/hooks.json

file

1,808 bytes

109d245c8eda961e…

hooks/pin-session-selection.sh

file

3,108 bytes

7d5d7af2cfcd914e…

hooks/pre-compact.sh

file

5,334 bytes

c0556caceefb653e…

hooks/session-start.sh

file

13,510 bytes

dbf037b1a4ec60e6…

hooks/state-dir-lib.sh

file

1,617 bytes

06c292556e9feb6b…

hooks/validate-agent-output.sh

file

8,756 bytes

aaf9b31a03207477…

README.md

file

45,234 bytes

309e401690d8955c…

SECURITY.md

file

1,330 bytes

170a8a89cd11f22a…

skills/build-unplanned/SKILL.md

skill

8,754 bytes

f804f7e27aae5c28…

skills/check-specs-alignment/SKILL.md

skill

9,147 bytes

ce016c5062d46621…

skills/create-tasks/SKILL.md

skill

18,040 bytes

9f91ff6bda3c16f7…

skills/debug/SKILL.md

skill

27,272 bytes

9f53cd76266e90fa…

skills/design-architecture/SKILL.md

skill

15,051 bytes

32af6bc6f8c801f6…

skills/design-it-twice/SKILL.md

skill

4,340 bytes

fbac7454b4ce5be0…

skills/design-product/SKILL.md

skill

16,444 bytes

6ae74617a680e3e2…

skills/domain-modeling/CONTEXT-FORMAT.md

skill

1,699 bytes

478942945eca005a…

skills/domain-modeling/SKILL.md

skill

5,011 bytes

045da7f32a371b87…

skills/doubt-driven-development/SKILL.md

skill

5,482 bytes

3f15ed855d327c5f…

skills/finalize-task/SKILL.md

skill

6,914 bytes

2e3ee06ed5a9b0a6…

skills/groundwork-check/SKILL.md

skill

1,380 bytes

41473efbac7760ed…

skills/groundwork-help/SKILL.md

skill

3,923 bytes

9063d34c1b50ee52…

skills/handoff/SKILL.md

skill

4,328 bytes

053336274bd52291…

skills/implement-task/SKILL.md

skill

12,612 bytes

5a20d72166ff7aeb…

skills/instrument-observability/SKILL.md

skill

3,629 bytes

4c56728484308cea…

skills/just-do-it-swarming/SKILL.md

skill

14,855 bytes

a5ad19b00be4f306…

skills/just-do-it/SKILL.md

skill

12,488 bytes

b387d4b3d1870636…

skills/plan-task/SKILL.md

skill

12,295 bytes

16aa0e0170b6720d…

skills/review-pr/SKILL.md

skill

17,383 bytes

f58cca86eeae7d0b…

skills/select-project/SKILL.md

skill

2,397 bytes

6cade7c8d7f62f8a…

skills/setup-repo/SKILL.md

skill

3,553 bytes

1b4b5d19984492c2…

skills/ship/SKILL.md

skill

3,638 bytes

6d077f7666152e52…

skills/skills/SKILL.md

skill

2,561 bytes

b52e7ad8e118e654…

skills/source-architecture-from-code/SKILL.md

skill

9,284 bytes

5a3681e2ebf179a3…

skills/source-product-specs-from-code/SKILL.md

skill

10,682 bytes

d5ca49c06f1a08db…

skills/source-ux-design-from-code/SKILL.md

skill

11,779 bytes

d8e28cec012ab378…

skills/split-architecture/SKILL.md

skill

6,854 bytes

9cb34fbb9b9609b2…

skills/split-specs/SKILL.md

skill

5,141 bytes

02194cf9c4a66749…

skills/staged-rollout/SKILL.md

skill

4,607 bytes

8085f1dd6f84f6cb…

skills/statusline/codex-skill-body.md

skill

2,434 bytes

a9f5548c0c43717f…

skills/statusline/SKILL.md

skill

3,430 bytes

22e92c30cd542298…

skills/swarm-debug/SKILL.md

skill

14,076 bytes

058826c8868ed9bd…

skills/swarm-design-architecture/SKILL.md

skill

20,687 bytes

6722ee36354949dc…

skills/task-validation-loop/SKILL.md

skill

8,642 bytes

8e57830151107f33…

skills/test-driven-development/SKILL.md

skill

15,760 bytes

fafb18413f20a346…

skills/understanding-feature-requests/SKILL.md

skill

3,257 bytes

cb8e5bad62d4102a…

skills/use-git-worktree/SKILL.md

skill

7,556 bytes

40344f95c03bafdb…

skills/using-groundwork/SKILL.md

skill

7,846 bytes

03000e32cdb2efa2…

skills/ux-design/SKILL.md

skill

41,530 bytes

d6d9f20709ccbb88…

skills/validate/SKILL.md

skill

41,880 bytes

dc123575f8b729b7…

skills/vertical-slice/SKILL.md

skill

4,614 bytes

24ec0e5836d9645b…

skills/work-on-next-task/SKILL.md

skill

6,642 bytes

9f8059dd640f14dd…

skills/work-on/SKILL.md

skill

13,729 bytes

c6e05e041be16ce1…