# techspokes/skill-base-template architecture

> Architecture diagram of the GitHub repository techspokes/skill-base-template, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/techspokes/skill-base-template
- Repository: https://github.com/techspokes/skill-base-template

## Overview

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: [`scripts/validate-evaluations.mjs`](https://github.com/techspokes/skill-base-template/blob/main/scripts/validate-evaluations.mjs) (Evaluation validator), [`scripts/package-release.mjs`](https://github.com/techspokes/skill-base-template/blob/main/scripts/package-release.mjs) (Release packager), [`skills/placeholder-skill/SKILL.md`](https://github.com/techspokes/skill-base-template/blob/main/skills/placeholder-skill/SKILL.md) (Canonical skill), [`scripts/verify-release-assets.mjs`](https://github.com/techspokes/skill-base-template/blob/main/scripts/verify-release-assets.mjs) (Asset verifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Skill creation"]
  node_intake["Source intake<br/>[README.md]"]
  node_adequacy["Intake assessment"]
  node_bootstrap["Bootstrap guidance"]
  node_cleanup["Cleanup boundaries"]
end

subgraph group_skill["Skill source"]
  node_skillsource["Canonical skill<br/>[SKILL.md]"]
  node_references["Runtime references"]
end

subgraph group_quality["Validation"]
  node_skillvalidator["Skill validator<br/>[validate-skill.mjs]"]
  node_evalvalidator["Evaluation validator"]
  node_evalcontracts["Evaluation contracts<br/>[cases.json]"]
  node_fixturecontracts["Agent surface contract"]
end

subgraph group_delivery["Release delivery"]
  node_packager["Release packager"]
  node_zip["ZIP archive utility<br/>[stored-zip.mjs]"]
  node_pluginmanifests["Plugin manifests"]
  node_preflight["Release preflight"]
  node_releasestate["Release state guard<br/>[release-state.mjs]"]
  node_assetverify["Asset verifier"]
  node_installverify["Install verifier"]
  node_generatedworkflows["Generated workflows<br/>[workflows]"]
end

node_author(("Skill author"))
node_agent(("Coding agent"))
node_npm(("Command-line user"))

node_author -->|"adds material"| node_intake
node_agent -->|"reads intake"| node_intake
node_agent -->|"assesses gaps"| node_adequacy
node_agent -->|"follows guidance"| node_bootstrap
node_agent -->|"builds skill"| node_skillsource
node_agent -->|"follows cleanup"| node_cleanup
node_skillsource -.->|"uses references"| node_references
node_npm -->|"runs validation"| node_skillvalidator
node_npm -->|"runs validation"| node_evalvalidator
node_evalvalidator -->|"reads registry"| node_evalcontracts
node_evalvalidator -->|"reads contract"| node_fixturecontracts
node_npm -->|"packages release"| node_packager
node_packager -->|"creates archives"| node_zip
node_packager -->|"reads manifests"| node_pluginmanifests
node_npm -->|"checks candidate"| node_preflight
node_npm -->|"guards release"| node_releasestate
node_npm -->|"verifies assets"| node_assetverify
node_assetverify -->|"reads archives"| node_zip
node_npm -->|"checks install"| node_installverify
node_agent -->|"installs workflows"| node_generatedworkflows

click node_intake "https://github.com/techspokes/skill-base-template/blob/main/.intake/README.md"
click node_adequacy "https://github.com/techspokes/skill-base-template/blob/main/.template/bootstrap/intake-adequacy-and-resolution.md"
click node_bootstrap "https://github.com/techspokes/skill-base-template/blob/main/.template/bootstrap/build-skill-from-intake.md"
click node_cleanup "https://github.com/techspokes/skill-base-template/blob/main/.template/bootstrap/cleanup-and-boundaries.md"
click node_skillsource "https://github.com/techspokes/skill-base-template/blob/main/skills/placeholder-skill/SKILL.md"
click node_references "https://github.com/techspokes/skill-base-template/tree/main/skills/placeholder-skill/references"
click node_skillvalidator "https://github.com/techspokes/skill-base-template/blob/main/scripts/validate-skill.mjs"
click node_evalvalidator "https://github.com/techspokes/skill-base-template/blob/main/scripts/validate-evaluations.mjs"
click node_evalcontracts "https://github.com/techspokes/skill-base-template/blob/main/tests/evals/cases.json"
click node_fixturecontracts "https://github.com/techspokes/skill-base-template/blob/main/tests/fixtures/agent-surface-contract.json"
click node_packager "https://github.com/techspokes/skill-base-template/blob/main/scripts/package-release.mjs"
click node_zip "https://github.com/techspokes/skill-base-template/blob/main/scripts/lib/stored-zip.mjs"
click node_pluginmanifests "https://github.com/techspokes/skill-base-template/tree/main/packaging"
click node_preflight "https://github.com/techspokes/skill-base-template/blob/main/scripts/release-preflight.mjs"
click node_releasestate "https://github.com/techspokes/skill-base-template/blob/main/scripts/release-state.mjs"
click node_assetverify "https://github.com/techspokes/skill-base-template/blob/main/scripts/verify-release-assets.mjs"
click node_installverify "https://github.com/techspokes/skill-base-template/blob/main/scripts/verify-gh-skill-install.mjs"
click node_generatedworkflows "https://github.com/techspokes/skill-base-template/tree/main/.template/generated/.github/workflows"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_intake,node_adequacy,node_bootstrap,node_cleanup,node_npm toneBlue
class node_skillsource,node_references toneAmber
class node_skillvalidator,node_evalvalidator,node_evalcontracts,node_fixturecontracts toneMint
class node_packager,node_zip,node_pluginmanifests,node_preflight,node_releasestate,node_assetverify,node_installverify,node_generatedworkflows toneRose
class node_author,node_agent toneIndigo
```

## Components

### Skill creation

- [Source intake](https://github.com/techspokes/skill-base-template/blob/main/.intake/README.md): `.intake/README.md`
- [Intake assessment](https://github.com/techspokes/skill-base-template/blob/main/.template/bootstrap/intake-adequacy-and-resolution.md): `.template/bootstrap/intake-adequacy-and-resolution.md`
- [Bootstrap guidance](https://github.com/techspokes/skill-base-template/blob/main/.template/bootstrap/build-skill-from-intake.md): `.template/bootstrap/build-skill-from-intake.md`
- [Cleanup boundaries](https://github.com/techspokes/skill-base-template/blob/main/.template/bootstrap/cleanup-and-boundaries.md): `.template/bootstrap/cleanup-and-boundaries.md`

### Skill source

- [Canonical skill](https://github.com/techspokes/skill-base-template/blob/main/skills/placeholder-skill/SKILL.md): `skills/placeholder-skill/SKILL.md`
- [Runtime references](https://github.com/techspokes/skill-base-template/tree/main/skills/placeholder-skill/references): `skills/placeholder-skill/references`

### Validation

- [Skill validator](https://github.com/techspokes/skill-base-template/blob/main/scripts/validate-skill.mjs): `scripts/validate-skill.mjs`
- [Evaluation validator](https://github.com/techspokes/skill-base-template/blob/main/scripts/validate-evaluations.mjs): `scripts/validate-evaluations.mjs`
- [Evaluation contracts](https://github.com/techspokes/skill-base-template/blob/main/tests/evals/cases.json): `tests/evals/cases.json`
- [Agent surface contract](https://github.com/techspokes/skill-base-template/blob/main/tests/fixtures/agent-surface-contract.json): `tests/fixtures/agent-surface-contract.json`

### Release delivery

- [Release packager](https://github.com/techspokes/skill-base-template/blob/main/scripts/package-release.mjs): `scripts/package-release.mjs`
- [ZIP archive utility](https://github.com/techspokes/skill-base-template/blob/main/scripts/lib/stored-zip.mjs): `scripts/lib/stored-zip.mjs`
- [Plugin manifests](https://github.com/techspokes/skill-base-template/tree/main/packaging): `packaging`
- [Release preflight](https://github.com/techspokes/skill-base-template/blob/main/scripts/release-preflight.mjs): `scripts/release-preflight.mjs`
- [Release state guard](https://github.com/techspokes/skill-base-template/blob/main/scripts/release-state.mjs): `scripts/release-state.mjs`
- [Asset verifier](https://github.com/techspokes/skill-base-template/blob/main/scripts/verify-release-assets.mjs): `scripts/verify-release-assets.mjs`
- [Install verifier](https://github.com/techspokes/skill-base-template/blob/main/scripts/verify-gh-skill-install.mjs): `scripts/verify-gh-skill-install.mjs`
- [Generated workflows](https://github.com/techspokes/skill-base-template/tree/main/.template/generated/.github/workflows): `.template/generated/.github/workflows`

### Other components

- **Skill author**
- **Coding agent**
- **Command-line user**

## Connections

- Skill author → Source intake: adds material (evidence: `README.md`)
- Coding agent → Source intake: reads intake (evidence: `README.md`)
- Coding agent → Intake assessment: assesses gaps (evidence: `README.md`)
- Coding agent → Bootstrap guidance: follows guidance (evidence: `README.md`)
- Coding agent → Canonical skill: builds skill (evidence: `README.md`)
- Coding agent → Cleanup boundaries: follows cleanup (evidence: `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 (evidence: `scripts/validate-evaluations.mjs`)
- Evaluation validator → Agent surface contract: reads contract (evidence: `scripts/validate-evaluations.mjs`)
- Command-line user → Release packager: packages release
- Release packager → ZIP archive utility: creates archives (evidence: `scripts/package-release.mjs`)
- Release packager → Plugin manifests: reads manifests (evidence: `scripts/package-release.mjs`)
- Command-line user → Release preflight: checks candidate (evidence: `README.md`)
- Command-line user → Release state guard: guards release (evidence: `scripts/release-state.mjs`)
- Command-line user → Asset verifier: verifies assets
- Asset verifier → ZIP archive utility: reads archives (evidence: `scripts/verify-release-assets.mjs`)
- Command-line user → Install verifier: checks install
- Coding agent → Generated workflows: installs workflows (evidence: `README.md`)
