sddl-init

Bootstraps sdd-lite project context, skill catalog, and AI agent configuration files.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nico0695/ai-tools --skill sddl-init-nico0695
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sddl-init
Source: https://github.com/nico0695/ai-tools/tree/main/sdd/sdd-lite/skills/sddl-init
Command: npx skills add https://github.com/nico0695/ai-tools --skill sddl-init-nico0695

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a spec-driven development workflow in a repository requires manually detecting the stack, documenting conventions, and wiring AI assistants like Claude Code or AGENTS.md-based agents. This Skill automates that bootstrap so later development stages can run without rediscovering basic repository facts. ## Core Features & Use Cases - Project Bootstrap: Scans manifests, lockfiles, configs, and docs to generate project-context.md, skill-catalog.md, and openspec/config.yaml under ./sdd-lite/. - AI Setup Installation: Detects Claude Code and AGENTS.md setups, then installs 12 skills and 8 execution-profile adapters as symlinks or copies with user confirmation. - Wrapper Injection: Injects demarcated orchestrator wrapper blocks (contract version 0.4) into CLAUDE.md or AGENTS.md after explicit user approval. - Use Case: A developer clones a repository and wants spec-driven development with Claude Code. Running the bootstrap detects the Node.js stack, records lint and test commands, symlinks the skills into .claude/skills/, and injects the orchestrator wrapper into CLAUDE.md. ## Quick Start Ask the AI to bootstrap sdd-lite in the current project by saying "run sddl-init to initialize sdd-lite in this repository".

Frequently Asked Questions about sddl-init

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

FAQPage Schema
How do I set up spec-driven development in an existing repository?▼

Run the sddl-init bootstrap, which scans your manifests, configs, and docs to generate project-context.md, skill-catalog.md, and config.yaml under ./sdd-lite/. It also installs skills and agent adapters for your detected AI setup after confirmation.

How to configure Claude Code with project skills and agents?▼

The bootstrap detects CLAUDE.md or a .claude/ directory, then installs 12 skills into .claude/skills/ as symlinks or copies and generates 8 execution-profile adapters in .claude/agents/. It can also inject a demarcated orchestrator wrapper block into CLAUDE.md with your approval.

Does sdd-lite work with AGENTS.md and Codex agents?▼

Yes, AGENTS.md, .agents/, and .codex/ directories are detected as the vendor-neutral agents setup. Skills install into .agents/skills/ and TOML execution-profile adapters are generated in .codex/agents/ with resolved model and reasoning effort values.

Should I install skills as symlinks or copies?▼

Choose symlinks when the package stays in the repository, since they point directly to package files with no duplication. Choose copies when the package may move or symlinks are unsupported, or when direct slash-command invocation is the primary use case.

What happens when I rerun the bootstrap on an initialized project?▼

Reruns refresh project-context.md, skill-catalog.md, and config.yaml, replace generated adapter files, and delete stale adapters whose ids are absent from profiles.yaml. User-owned template overrides under ./sdd-lite/templates/ are never touched.

What are the limitations of the bootstrap repository scan?▼

The scan is intentionally shallow, reading at most 6 extra files for convention detection beyond the initial high-signal scan. Conventions not evident within that budget are recorded as not established rather than investigated further.