@ikenga/skill-groundwork
v0.7.6
Published
Reusable research → design → plan → orchestrate → act skill for Claude Code.
Maintainers
Readme
@ikenga/skill-groundwork
A Claude Code skill that scaffolds and maintains a reusable research → design → plan → orchestrate → act folder for any non-trivial work — software features, marketing campaigns, org changes.
It drops a domain-agnostic spine (00-README · 01-plan · 02/03
research · 04-discussion newest-first · 05-tracking ·
09-orchestration) plus stateless action-skills that augment the docs in
place without clobbering hand-written prose. Profile-driven: software,
general, content, and design-system. Each plan also gets self-contained
HTML views — a board (artifact/board.html), a fully-offline file
explorer with search (artifact/explorer.html), and a cross-plan
plans index (<plans-dir>/_index.html).
Install
# Global install (recommended — available across all projects)
npx skills add ikenga-hq/groundwork -g
# Project install (committed with your repo)
npx skills add ikenga-hq/groundworknpx skills add resolves skills/groundwork/SKILL.md and symlinks it into
~/.claude/skills/groundwork/.
Source of truth & publish flow
There is one editable copy. As of the 2026-08-21 unification, the dev source moved
into this package — ./skills/groundwork/ is the source. Edit it directly.
| Copy | Path | Role |
|---|---|---|
| Source (this package) | ikenga-pkgs/packages/skills/groundwork/skills/groundwork/ | ADR-009 home, Changesets-versioned. Edit here. |
| Workspace dogfood | <ikenga-workspace>/.claude/skills/groundwork/ | A symlink into the path above — not a copy. |
| Published mirror | ikenga-hq/groundwork | The npx skills add install surface. Built FROM this package. |
Why the change: the previous layout kept the dev source in ikenga-workspace, which is
private, and copied it into this public package via sync-from-dev.mjs. Contributors
could read the published skill but not the file anyone actually edited, and every change
needed a sync hop that could silently drift. The script is gone; there is nothing to drift.
Files no longer carry a GENERATED banner, because they are no longer generated.
PORTABILITY.md was emitted by the old sync script and is now hand-maintained source.
pnpm build:mirror— emits the standaloneikenga-hq/groundworkmirror tree (package.json + README + install.sh +skills/groundwork/) to./dist-mirrorfor review before pushing. Note the mirror repo's ownREADME.md,CONTRIBUTING.md,.github/andassets/are hand-maintained there and are not emitted — a blanket sync would delete them.
Portability
The skill's docs and the standalone board carry a few
this-workspace-internal references (plans/studio / plans/groundwork)
that are illustrative in a target project. See
skills/groundwork/PORTABILITY.md for the
full disclosure.
License
Apache-2.0. Copyright © 2026 Royalti.io.
