skills.rest
albersg
albersgCOMMUNITY
Explore all skills by this author →
GitHub

sdd-init

Initialize SDD project context, testing capabilities, and skill registry with persistence.

Updated Mar 7, 2026
Search Tags:#tdd#sdd#initialization#openspec#project detection#skill registry#testing capabilities
One-click install
npx skills add https://github.com/albersg/dotfiles --skill sdd-init-albersg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-init
Source: https://github.com/albersg/dotfiles/tree/main/dotfiles-opencode/.opencode/skills/sdd-init
Command: npx skills add https://github.com/albersg/dotfiles --skill sdd-init-albersg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up Spec-Driven Development in a project requires manually detecting the tech stack, test tooling, and conventions, then wiring up persistence and registries. This Skill automates that initialization so SDD phases start from accurate, detected project context instead of guesses. ## Core Features & Use Cases - Stack and Tooling Detection: Inspects package.json, go.mod, pyproject.toml, CI, and lint/test configs to identify the real stack, test runner, coverage, linter, type checker, and formatter. - Flexible Persistence Modes: Supports engram, openspec, hybrid, and none modes, writing Engram observations, openspec/config.yaml files, or both. - Skill Registry Generation: Builds .atl/skill-registry.md by scanning user-level and project-level skill directories across many AI agent platforms. - Use Case: When starting SDD on an existing repository, run the init phase to detect that the project uses vitest with coverage and ESLint, persist those testing capabilities, and produce a registry of available skills for later phases like sdd-explore or sdd-new. ## Quick Start Ask the agent to initialize SDD for this project and detect the stack, testing tools, and persistence mode.

Frequently Asked Questions about sdd-init

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

FAQPage Schema
How do I initialize SDD in an existing project?▼

Run the sdd-init phase, which inspects files like package.json, go.mod, and pyproject.toml to detect the stack and test tooling. It then persists context and testing capabilities according to the chosen mode and builds the skill registry.

What is the difference between engram, openspec, and hybrid persistence modes?▼

Engram mode saves context and capabilities only to Engram memory without creating openspec files. Openspec mode writes file artifacts under openspec/ including config.yaml, while hybrid mode does both. The none mode returns detected context without writing SDD artifacts.

How is strict TDD mode determined during initialization?▼

Strict TDD is resolved from an explicit agent marker or openspec/config.yaml first. If none exists but a test runner is detected, it defaults to true; with no test runner it is set to false and reported as unavailable.

What does the skill registry scan include?▼

The scan covers user-level skill directories for many agent platforms such as Claude, Gemini, Cursor, and OpenCode, plus project-level skill folders. It skips sdd-*, _shared, and skill-registry entries, deduplicates by name, and prefers project-level skills.

What happens if openspec already exists in the project?▼

The initializer reports what already exists and asks before updating it, rather than overwriting existing openspec content. This prevents accidental loss of prior SDD configuration.

Related Skills

Explore More Software Engineering Skills→
ViperJuiceViperJuice
8

library-detection

Detect languages, frameworks, and build tools from package manifests.

Community
Intermediate
Gentleman-ProgrammingGentleman-Programming
6.1k

sdd-onboard

Guides users through a complete Spec-Driven Development cycle on their real codebase.

Official
Advanced
flightctlflightctl
6

ai-ready

Scan codebase structure and convention files to generate or refresh AGENTS.md.

Official
Intermediate
tiagofurtiagofur

sdd-init

Bootstrap openspec/ directories with config.yaml, specs/, and changes/.

Community
Advanced