How techspokes/skill-base-template works
Skill Base Template guides an author and coding agent from raw .intake/ material to a standalone agent skill, then supports validation and release preparation. The map preserves documented intake assessment, bootstrap and cleanup guidance, runtime skill content, validation, and release-delivery capabilities. Source excerpts show the packaging/archive and install-verification implementations; several bootstrap and workflow branches are documented but unsampled, so those connections cite the README rather than implying inspected implementation details.
Main entry points: validate-evaluations.mjs Evaluation validator · package-release.mjs Release packager · SKILL.md Canonical skill · verify-release-assets.mjs Asset verifier
Components 21
Skill creation
- Source intake
.intake/README.md - Intake assessment
.template/bootstrap/intake-adequacy-and-resolution.md - Bootstrap guidance
.template/bootstrap/build-skill-from-intake.md - Cleanup boundaries
.template/bootstrap/cleanup-and-boundaries.md
Skill source
- Canonical skill
skills/placeholder-skill/SKILL.md - Runtime references
skills/placeholder-skill/references
Validation
- Skill validator
scripts/validate-skill.mjs - Evaluation validator
scripts/validate-evaluations.mjs - Evaluation contracts
tests/evals/cases.json - Agent surface contract
tests/fixtures/agent-surface-contract.json
Release delivery
- Release packager
scripts/package-release.mjs - ZIP archive utility
scripts/lib/stored-zip.mjs - Plugin manifests
packaging - Release preflight
scripts/release-preflight.mjs - Release state guard
scripts/release-state.mjs - Asset verifier
scripts/verify-release-assets.mjs - Install verifier
scripts/verify-gh-skill-install.mjs - Generated workflows
.template/generated/.github/workflows
Other components
- Skill author
- Coding agent
- Command-line user
Connections 20
- Skill author → Source intake: adds material
README.md - Coding agent → Source intake: reads intake
README.md - Coding agent → Intake assessment: assesses gaps
README.md - Coding agent → Bootstrap guidance: follows guidance
README.md - Coding agent → Canonical skill: builds skill
README.md - Coding agent → Cleanup boundaries: follows cleanup
README.md - Canonical skill → Runtime references: uses references
- Command-line user → Skill validator: runs validation
- Command-line user → Evaluation validator: runs validation
- Evaluation validator → Evaluation contracts: reads registry
scripts/validate-evaluations.mjs - Evaluation validator → Agent surface contract: reads contract
scripts/validate-evaluations.mjs - Command-line user → Release packager: packages release
- Release packager → ZIP archive utility: creates archives
scripts/package-release.mjs - Release packager → Plugin manifests: reads manifests
scripts/package-release.mjs - Command-line user → Release preflight: checks candidate
README.md - Command-line user → Release state guard: guards release
scripts/release-state.mjs - Command-line user → Asset verifier: verifies assets
- Asset verifier → ZIP archive utility: reads archives
scripts/verify-release-assets.mjs - Command-line user → Install verifier: checks install
- Coding agent → Generated workflows: installs workflows
README.md