sw-init

Initialize Specwright by detecting the development stack and generating configuration files.

9|1|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Obsidian-Owl/specwright --skill sw-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sw-init
Source: https://github.com/Obsidian-Owl/specwright/tree/main/skills/sw-init
Command: npx skills add https://github.com/Obsidian-Owl/specwright --skill sw-init

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the initial setup of Specwright within a project, ensuring all necessary configurations, anchor documents, and quality gates are established based on the project's stack and user preferences.

Core Features & Use Cases

  • Automated Project Detection: Scans the codebase to identify languages, frameworks, package managers, and test runners.
  • Guided Configuration: Interactively asks the user about their development practices, quality expectations, and Git workflow preferences.
  • Artifact Generation: Creates essential configuration files (.specwright/config.json), foundational documents (CONSTITUTION.md, CHARTER.md), and initializes state files.
  • Use Case: When starting a new project or integrating Specwright into an existing one, this Skill handles the complex initial setup, ensuring a solid foundation for AI-driven development.

Quick Start

Run the sw-init skill to set up Specwright in the current project directory.

Frequently Asked Questions about sw-init

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

FAQPage Schema
How do I initialize Specwright project configuration automatically?

To initialize Specwright project configuration, run the sw-init skill in your project directory. It scans the codebase to detect languages and frameworks, then interactively gathers your development practices to generate config files and foundational documents.

What is automated project stack detection for development standards setup?

Automated project stack detection scans your codebase to identify package managers, test runners, and frameworks. This ensures the generated development standards and quality gates match your specific technical environment and Git workflow preferences.

Can I use Specwright init to generate a project constitution and charter?

Yes, you can use Specwright init to generate a project constitution and charter. The process involves conversing with you for qualitative inputs regarding project vision, which establishes foundational documents alongside quality gates and hooks.

What's the best way to set up quality gates and hooks for a new project?

The best way to set up quality gates and hooks is through guided configuration initialization. The skill detects your development stack and asks about your quality expectations to configure these gates automatically within the generated configuration files.

Does Specwright initialization work with existing codebases or only new projects?

Specwright initialization works with both existing codebases and new projects. It scans the current directory to identify existing technical details and combines them with your user inputs to establish development standards and project vision.

Why do I need to provide qualitative inputs during project initialization?

Qualitative inputs are needed during project initialization to capture your development practices, quality expectations, and Git workflow preferences. While codebase scanning handles technical details, your inputs establish the project vision and constitution.