skill-harness is the setup repo for the 45ck agent workflow stack.
It does five jobs:
- installs the shared skill-pack suite
- installs the shared Claude and Codex agents
- bootstraps project-level tooling with
@45ck/noslopand45ck/agent-docs - optionally bootstraps Beads, enabled by default in project setup
- hosts embedded packs for suite-local or incubating capabilities
- remote dependency packs plus embedded local packs under
packs/ - shared skills synced into
~/.claude/skills/and~/.agents/skills/ - shared Claude agents
- shared Codex agents
Use the project setup command when you want a repo scaffolded with the 45ck tooling stack:
./skill-harness setup-project --dir path/to/projectThat command:
- auto-detects monorepo roots from workspace markers such as
pnpm-workspace.yaml,package.jsonworkspaces,nx.json,turbo.json,lerna.json, andrush.json - auto-detects
npm,pnpm,yarn, orbunfrom lockfiles orpackageManager - defaults to monorepo-root setup when the target directory is inside a detected monorepo
- creates a
package.jsonin the resolved setup directory if one does not exist yet - installs
@45ck/noslopand45ck/agent-docs - installs the Beads CLI if it is not already present
- runs
agent-docs init - runs
noslop init - runs
bd init - runs
agent-docs install-gates --quality
Five controlled experiments measured the toolkit (specgraph + noslop + skills) against raw Claude Code. Full data in experiments/RESULTS.md.
| Experiment | Toolkit | Baseline | Delta |
|---|---|---|---|
| Small greenfield (×2 runs) | 31–32 / 35 | 19–20 / 35 | +12 |
| Large greenfield (3 modules) | 32 / 35 | 19 / 35 | +13 |
| Maintenance / handoff | 33 / 35 | 19 / 35 | +14 |
| Ambiguous brief | 35 / 35 | 13 / 35 | +22 |
The gap is driven by scope enforcement and traceability — not code quality (functional output was equal in every experiment). The largest signal came from the ambiguous brief: the toolkit forced scope decisions before code was written; the baseline built a 4-class framework for a task that needed a 3-function library.
git clone https://github.com/45ck/skill-harness.git
cd skill-harness
go build -o skill-harness ./cmd/skill-harnessWindows:
git clone https://github.com/45ck/skill-harness.git
cd skill-harness
go build -o skill-harness.exe .\cmd\skill-harnessbash install.sh.\install.ps1Release bundles can ship the binary plus the repo files together so Go is not required.
Build them with:
python scripts/build_release.py --version v0.1.0./skill-harness install --all./skill-harness install --agents=requirements-analyst,system-modeler,security-reviewer./skill-harness install --packs=business-analysis-skills,documentation-evidence-skills --packs-only./skill-harness install --interactive./skill-harness setup-project --dir ../my-projectInstall only the packages and skip initialization:
./skill-harness setup-project --dir ../my-project --install-onlyMonorepo auto mode:
./skill-harness setup-project --dir ../my-monorepo/apps/webForce workspace-local setup instead of lifting to the monorepo root:
./skill-harness setup-project --dir ../my-monorepo/apps/web --scope workspaceOverride package manager if auto-detection is not what you want:
./skill-harness setup-project --dir ../my-monorepo --package-manager pnpmSkip one tool:
./skill-harness setup-project --dir ../my-project --skip-agent-docs
./skill-harness setup-project --dir ../my-project --skip-noslop
./skill-harness setup-project --dir ../my-project --skip-beads./skill-harness check --allrequirements-analystrequirements-analyst-beadsux-researchersystem-modelersystem-modeler-beadssoftware-architectsoftware-architect-beadsweb-engineerbackend-engineertest-designertest-designer-beadsqa-automation-engineerquality-reviewersecurity-reviewersecurity-reviewer-beadspentest-reviewerdelivery-managerdelivery-manager-beadsresearch-writerworkflow-engineer
Agent-to-skill mapping lives in docs/agent-loadouts.md.
45ck/agile-delivery-skills45ck/authentication-cryptography-skills45ck/automation-testing-skills45ck/backend-persistence-skills45ck/business-analysis-skills45ck/code-review-inspection-skills45ck/data-structures-algorithmic-reasoning-skills45ck/deployment-release-skills45ck/design-for-testability-skills45ck/documentation-evidence-skills45ck/enterprise-architecture-integration-skills45ck/hci-review-skill45ck/llm-agent-security-skills45ck/maintenance-evolution-skills45ck/non-functional-testing-skills45ck/oop-code-structure-skills45ck/pentest-security-testing-skills45ck/project-management-skills45ck/refactoring-code-smells-skills45ck/research-literature-review-skills45ck/security-engineering-skills45ck/software-architecture-skills45ck/software-quality-skills45ck/uml-analysis-modelling-skills45ck/verification-test-design-skills45ck/web-engineering-skillscoding-workflow-skills(embedded)design-tooling-skills(embedded)integration-tooling-skills(embedded)
The standard full toolkit for a new project is specgraph + noslop. The setup-project command installs both automatically. For manual installation steps or to install the matching skill packs (specgraph-skills, noslop-skills), see AGENT_INSTRUCTIONS.md.
If another agent needs to install this repo or use it as the setup entrypoint, point it at AGENT_INSTRUCTIONS.md.