ground-project

Fills scaffold tokens and grounds skill markers in real project code facts.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/dxiiren/project-skeleton --skill ground-project-dxiiren
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ground-project
Source: https://github.com/dxiiren/project-skeleton/tree/main/.claude/skills/ground-project
Command: npx skills add https://github.com/dxiiren/project-skeleton --skill ground-project-dxiiren

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running a mechanical project scaffolder, the generated CLAUDE.md, README, .docs set, and Claude skill kit still contain placeholder tokens and [GROUND: ...] markers that require actually reading the project's code to fill correctly. This Skill performs that one-time intelligent grounding pass so no placeholder content survives into daily development. ## Core Features & Use Cases - Token and marker resolution: Sweeps for remaining content tokens in CLAUDE.md, README, and .docs, and resolves every [GROUND: ...] marker across the core skills using facts read from the real codebase. - Optional skill enablement: Evaluates prerequisites (CI workflows, Playwright, typecheck configs, phpstan) and moves qualifying optional skills into the active skills directory. - Audit and boot-verify loop: Runs the skill audit until PASS, then boot-verifies the project via setup.ps1, just start/build, and probe checks, feeding real symptoms into troubleshooting docs. - Use Case: After cloning the project-skeleton and running init.ps1 for a new static-site app, invoke the grounding pass so Claude reads the actual routes and justfile, fills every doc placeholder, enables the applicable optional skills, and verifies the app boots before handing off for review. ## Quick Start Tell Claude to run /ground-project after init.ps1 completes so it reads the real code and finishes the scaffolding kit.

Frequently Asked Questions about ground-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I finish scaffolding after running init.ps1?

Run the /ground-project command in Claude Code after init.ps1 completes. It reads the conventions doc and your real code, fills every remaining content token in CLAUDE.md, README, and .docs, and resolves all [GROUND: ...] markers in the core skills.

What does the ground-project skill actually change in my repo?

It fills placeholder tokens in CLAUDE.md, README, and .docs, localizes the 13 core skills with repo-specific facts, moves qualifying optional skills into .claude/skills, and updates troubleshooting docs with real boot-verify symptoms. It does not commit anything.

When are optional skills like monitor-ci or fix-typecheck enabled?

Optional skills are enabled only when their prerequisite exists in the real code, such as CI workflow files for monitor-ci or a tsconfig.json for fix-typecheck. Non-qualifying skills stay inert in .claude/skills-optional/.

Why does the skill audit fail after grounding?

The audit fails on registration rows, frontmatter issues, model fields, or BOMs in skill files. Fix whatever audit.py reports and re-run it until it prints RESULT: PASS; the script itself should not be weakened.

Can I skip the boot-verify step during grounding?

No. Boot-verify runs setup.ps1, just start or build, probes the app, and confirms no orphaned processes. Troubleshooting docs written without it would contain invented symptoms rather than real ones.