dev-init

Create standard documentation templates in a repository without overwriting existing files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Automates the scaffolding of a new repository by creating standard project docs and structure without overwriting existing files.

Core Features & Use Cases

  • Create AGENTS.md and CLAUDE.md at the repo root
  • Create docs/ARCHITECTURE.md, docs/CONVENTIONS.md, docs/TECH_DEBT.md
  • Template-driven and non-destructive: only creates missing files

Quick Start

Run the dev-init skill in the repository root to generate the standard project docs, creating missing files and leaving existing ones intact.

Frequently Asked Questions about dev-init

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

FAQPage Schema
How do I generate standard documentation files when scaffolding a new repository?

To generate standard documentation files when scaffolding a new repository, you can run an initialization skill to create baseline docs like AGENTS.md and ARCHITECTURE.md. This process applies template-driven file creation to establish consistent project structure.

Can I create project documentation templates without overwriting my existing repo files?

Yes, you can create project documentation templates without overwriting existing repo files. The initialization process is non-destructive, meaning it only generates missing files like CLAUDE.md or CONVENTIONS.md and leaves your current files intact.

What standard markdown files are needed for AI agent onboarding in a new project?

Standard markdown files needed for AI agent onboarding include AGENTS.md and CLAUDE.md at the repo root. These templates provide baseline context and conventions for automated tools interacting with your codebase.

Does running a repo initialization script replace existing architecture or tech debt docs?

No, running a repo initialization script does not replace existing architecture or tech debt docs. The file creation is non-destructive and strictly skips any existing files, preserving your current documentation.

Where should I place ARCHITECTURE.md and CONVENTIONS.md during project setup?

During project setup, you should place ARCHITECTURE.md, CONVENTIONS.md, and TECH_DEBT.md inside a docs/ directory. The root level should contain AGENTS.md and CLAUDE.md for immediate repository visibility.