Skip to content
Skills Library
Programming · Building & coding

init-project

/init-project

Use this skill for \"initialize project\", \"set up project\", \"scaffold project\", \"create AGENTS.md\", \"create CLAUDE.md\", \"set up rules\", \"create context directory\", \"vibe rules\", \"project templates\", \"init new project\", \"set up development structure\", \"create .rules\", \"create .context\", \"create ADR\", \"architecture decision records\", \"set up GitHub labels\", \"default issue labels\", \"project scaffolding\", \"set up pre-commit hooks\", or when the user wants to initialize a new project with cross-agent development templates, structured documentation, and an optiona

Licence
BSD-3-Clause
Last repository change
23.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

BSD-3-Clause, otwarta.

What it does and when to use it

Use this skill for \"initialize project\", \"set up project\", \"scaffold project\", \"create AGENTS.md\", \"create CLAUDE.md\", \"set up rules\", \"create context directory\", \"vibe rules\", \"project templates\", \"init new project\", \"set up development structure\", \"create .rules\", \"create .context\", \"create ADR\", \"architecture decision records\", \"set up GitHub labels\", \"default issue labels\", \"project scaffolding\", \"set up pre-commit hooks\", or when the user wants to initialize a new project with cross-agent development templates, structured documentation, and an optiona

Triggers from the description

initialize project\set up project\scaffold project\create AGENTS.md\create CLAUDE.md\set up rules\create context directory\vibe rules\
Original author description

Use this skill for \"initialize project\", \"set up project\", \"scaffold project\", \"create AGENTS.md\", \"create CLAUDE.md\", \"set up rules\", \"create context directory\", \"vibe rules\", \"project templates\", \"init new project\", \"set up development structure\", \"create .rules\", \"create .context\", \"create ADR\", \"architecture decision records\", \"set up GitHub labels\", \"default issue labels\", \"project scaffolding\", \"set up pre-commit hooks\", or when the user wants to initialize a new project with cross-agent development templates, structured documentation, and an optiona

How it works

  1. When to Use
  2. Template Structure
  3. Initialization Workflow
  4. Core Principles Enforced by Templates
  5. Rules Directory Reference
  6. Context Directory Reference
Original SKILL.md headings · 170 lines, 1,070 words
SKILL.md preview
---
name: init-project
description: "Use this skill for \"initialize project\", \"set up project\", \"scaffold project\", \"create AGENTS.md\", \"create CLAUDE.md\", \"set up rules\", \"create context directory\", \"vibe rules\", \"project templates\", \"init new project\", \"set up development structure\", \"create .rules\", \"create .context\", \"create ADR\", \"architecture decision records\", \"set up GitHub labels\", \"default issue labels\", \"project scaffolding\", \"set up pre-commit hooks\", or when the user wants to initialize a new project with cross-agent development templates, structured documentation, and an optional default GitHub label set."
version: 0.2.1
user-invocable: false
---

# Project Initialization with Vibe Rules Templates

Initialize new projects with a structured development environment for Codex, Claude Code, Copilot, and optionally Cursor. The templates enforce consistent development practices: real testing (no mocks), atomic commits, documentation-driven development, and continuous rule improvement.

## When to Use

- Starting a new project from scratch
- Adding cross-agent structure to an existing project
- Setting up .rules/ and .context/ directories for a project that lacks them
- Migrating a project to vibe-rules conventions

Partial-init detection: if AGENTS.md or .rules/ already exists, this is not a
fresh init. Inventory what exists first; scaffold only the missing pieces
(never overwrite an existing AGENTS.md or customized rule), and use the
update-rules skill instead when the ask is to refresh existing files against
newer templates. For understanding an existing codebase before documenting
it, run codebase-onboarding first and reuse its report for the architecture
map in Step 4.

## Template Structure

The plugin bundles all templates under `templates/`:

```
templates/
  agents/           # Shared agent templates
    AGENTS.md       # Main cross-agent instructions file
  claude/           # Claude Code adapter templates
    CLAUDE.md       # Imports AGENTS.md, then holds Claude-only guidance
    rules/          # Detailed rule references
      testing.md      # NO MOCK testing policy
      git.md          # Version control standards
      python.md       # Python/UV standards
      code_review.md  # PR review toolkit
      documentation.md # MkDocs standards
      ci_cd.md        # GitHub Actions setup
      self_improve.md  # Rule evolution
      serena_mcp.md    # Code intelligence tools
  context/          # Documentation scaffolding
    plan.md           # Task tracking with phases
    ideas.md          # Design concepts
    research.md       # Technical explorations
    scratch_history.md # Failed attempts and lessons
    decisions/        # Architecture Decision Records
      README.md         # ADR convention (numbering, statuses, when to write one)
      0000-template.md  # Template for new ADRs (do not edit)
  memory/           # Durable, cross-agent project observations
    README.md         # Fact format, staleness, boundaries, and safety rules
    INDEX.md          # One-line discovery index
  config/           # Development configuration
    pre-commit        # Ruff pre-commit hook (Python)
    pyproject.toml    # Python project config
    pytest.ini        # Pytest config
    mkdocs.yml        # Documentation config
    gitignore-template # Common ignores
  github/           # CI/CD templates
    workflows/
      test.yml        # Test pipeline
      docs.yml        # Documentation deployment
      release.yml     # Release automation
  cursor/           # Cursor IDE templates (optional)
    .cursorrules      # Main cursor config
    core_rules/       # Modular .mdc rule files
    planning/
      default/        # Plan-based development workflow
      advanced-taskmaster/ # Complex project task management
```

## Initialization Workflow

### Step 1: Detect project type

Scan the current directory for language markers:
- `pyproject.toml`, `requirements.txt`, `setup.py` -> Python project
- `package.json` -> Node.js/JavaScript/TypeScript project
- `Cargo.toml` -> Rust project
- `go.mod` -> Go project

### Step 2: Copy core templates

Copy with safety checks (never overwrite existing files):
1. **AGENTS.md** from `templates/agents/AGENTS.md`
2. **CLAUDE.md** from `templates/claude/CLAUDE.md` (contains `@AGENTS.md`, then Claude-only guidance)
3. **.rules/** from `templates/claude/rules/` (all .md files)
4. **.context/** from `templates/context/` (plan, ideas, research, scratch_history)
5. **.context/decisions/** from `templates/context/decisions/` (ADR template and README). Created separately so existing projects that already have `.context/` still pick it up on re-run.
6. **.memory/** from `templates/memory/` (README and INDEX). Created separately so existing projects pick up the convention without overwriting any project memory entries.

`.memory/` is tracked project data, not a private agent cache. The initializer
adds only missing template files on reruns and never overwrites an existing
memory entry or customized README/INDEX. Read its README before writing a fact.

### Step 3: Language-specific setup

**Python projects:**
- Install pre-commit hook from `templates/config/pre-commit` (runs ruff on staged files)
- Reference `templates/config/pyproject.toml` and `templates/config/pytest.ini` for configuration examples

**All projects:**
- Offer GitHub Actions workflows from `templates/github/workflows/` if `.github/workflows/` does not exist

### Step 4: Customize AGENTS.md and keep CLAUDE.md as an adapter

Replace template placeholders with project-specific values:
- `{{PROJECT_NAME}}` in AGENTS.md - actual project name
- `{{framework}}` in AGENTS.md - detected framework (e.g., Django, FastAPI, Next.js)
- `{{TECH_STACK}}` in context/plan.md - detected languages and frameworks

Tailor the content:
- Remove rules that do not apply. Test: a rule applies if its language or tool
  appears in the repo's manifests or file extensions (python.md stays only if
  pyproject.toml or *.py exist; docker rules stay only if a Dockerfile or
  compose file exists).
- Add a project-specific architecture map: 3-8 bullet lines, one per
  component, each naming its directory and one-line responsibility, plus how
  they connect. Use the codebase-onboarding skill's report as the source when
  the repo is not trivial.
- Document existing conventions already in place: infer from the code, not
  from preference (test framework actually used, naming pattern of the three
  most recent modules, error-handling idiom of the main package)
- Ensure .context/ files have project-relevant instructions
- Keep shared project instructions in AGENTS.md
- Keep CLAUDE.md as `@AGENTS.md`, then append only Claude Code-specific plugin, skill, command, or MCP guidance below the import

### Step 5: Cursor setup (optional)

Only if the user requests it or uses Cursor:
- Copy `.cursorrules` from `templates/cursor/`
- Copy `core_rules/` .mdc files
- Offer planning workflow choice: default (plan-based) or advanced-taskmaster

### Step 6: GitHub labels (optional, post-push)

If (and only if) the project has been pushed to GitHub and the user opts in, install a default issue label set:

```bash
project-init-labels .
```

The script is idempotent (uses `gh label create --force`) and installs:
- **Type:** `feature`, `bug`, `chore`, `docs`, `refactor`
- **Priority:** `P0` (critical), `P1` (high), `P2` (medium), `P3` (low)
- **Workflow:** `epic`, `blocked`, `needs-triage`, `good first issue`, `help wanted`

Skip this step entirely if the project is not on GitHub yet, or if the user prefers to manage labels by hand. Do not run it without asking.

### Step 7: Verify and summarize

List created files and directories. Confirm the structure is correct before the user starts working.

## Core Principles Enforced by Templates

Read `references/core-principles.md` for the full rationale behind each principle.

1. **NO MOCKS** - Test with real data, real databases, real APIs. No mocks, stubs, or fake data.
2. **Atomic commits** - One logical change per commit, messages <50 chars, no emojis, no AI attribution.
3. **Documentation-driven** - Four .context/ files track plan, ideas, research, and failed attempts.
4. **No technical debt** - Address all PR review findings in at most two review rounds. Replace, do not deprecate.
5. **Tool consistency** - UV for Python, Bun for JS/TS, Ruff for linting, Ty for type checking.
6. **Rule evolution** - Extract patterns used 3+ times into rules. Mine failures into prevention rules.

## Rules Directory Reference

Read `references/rules-guide.md` for detailed descriptions of each rule file and when to include or exclude them.

## Context Directory Reference

Read `references/context-guide.md` for how to use each .context/ file effectively.
Files in this package (4)
  • SKILL.md 9 KB
  • references/context-guide.md 4 KB
  • references/core-principles.md 3 KB
  • references/rules-guide.md 2 KB

Versions

RepositoryScoreLicence
This page · neuromechanist/research-skills100BSD-3-Clause
cardene777/agent-shuriken100MIT
microbus-io/fabric100Apache-2.0
popiliadam/platinum-seo-engine100AGPL-3.0
huangwb8/skills100MIT
kangig94/coral92MIT

Database snapshot: 13.11.2026 · package version 6f5ba225e61a (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90Project Scaffolding
    This skill should be used when the user wants to set up Claude for a project, create a CLAUDE.md file, scaffold the .claude directory, initialize an AI workflow, configure a project for Claude, set up dev intelligence, initialize a new project, or do a new project setup.…
  • 84init
    Initialize a new project with a standard directory structure, template files, and a git repository. Use this skill whenever the user starts a new project, types /init, asks to "set up a new project", "initialize a repo", "scaffold a project", or wants to create the standard…
  • 95project-init
    Use this skill when the user says 'create project structure', 'scaffold project', 'initialize project', 'set up folder structure', 'new project from scratch', or when a new project needs folders and config files created. This skill scaffolds the full project tree based on…
  • 100ctx-init
    Initialize AGENTS.md + CLAUDE.md + rules/ in a code repo (fresh mode). Triggers on "/ctx-init", "init context", "scaffold AGENTS.md", or when user asks to set up project context in a new repo.
  • 100docs-init
    Bootstraps a documentation structure (architecture, onboarding, data-model, deployment, security, contributing, and a first ADR) for a project that has little or no docs/ directory, exploring the codebase and populating templates only with content evidenced in the code. Use when…
  • 95init
    Initialize ADR Kit in a project. Use for adr-kit init, first-time ADR setup, architecture audit, managed guidance, and the pre-commit gate.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.