spec-init

Initialize the .spec/ directory with registry, taxonomy, and shard indexes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/telefrek/jlsm --skill spec-init-telefrek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-init
Source: https://github.com/telefrek/jlsm/tree/main/.claude/skills/spec-init
Command: npx skills add https://github.com/telefrek/jlsm --skill spec-init-telefrek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill bootstraps the .spec/ directory structure for operational specifications, setting up the registry, domain taxonomy, and shard indexes for a new project.

Core Features & Use Cases

  • Domain Taxonomy Collection: Collects and suggests major technical domains for a project.
  • Registry Creation: Sets up the registry directory and manifest files.
  • Domain Directory & Index Creation: Creates directories and indexes for each domain.
  • Existing Spec Ingestion: Allows for the ingestion of existing spec files (optional).
  • Final Validation: Runs a corpus health check to ensure everything is set up correctly.

Quick Start

Initialize the spec corpus for your project by running 'spec-init'.

Frequently Asked Questions about spec-init

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

FAQPage Schema
How do I initialize an operational specification corpus for a new project?

Initializing a specification corpus requires bootstrapping the .spec/ directory by collecting domain taxonomy, setting up the registry, and creating shard indexes. This process ensures the corpus is fully prepared for subsequent specification development and resolution.

What is a domain taxonomy in specification management?

A domain taxonomy in specification management is a structured classification of major technical domains for a project. Collecting this taxonomy during corpus initialization helps organize operational specifications by domain directories and shard indexes for efficient retrieval and resolution.

Can I ingest existing specification files when setting up a new spec corpus?

Yes, you can ingest existing specification files during corpus initialization. The setup process optionally allows for the ingestion of existing spec files into the newly created registry and domain directories before running a final validation health check.

Does spec-init require any dependencies or prerequisite tools to run?

No dependencies are required to run spec-init. The Skill operates independently using its internal scripts and references to bootstrap the .spec/ directory, create the registry, and establish shard indexes without relying on external tools or frameworks.

What is the best way to validate operational specification corpus health after project setup?

The best way to validate operational specification corpus health is to run the final validation check built into the initialization process. This health check ensures the registry, domain directories, and shard indexes are all structurally sound and correctly set up.