skills.rest
honerlaw
honerlawCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

init

Create .minerva/work and .minerva/knowledge directories and wire agent routing.

Updated May 16, 2026
Search Tags:#agent routing#project scaffolding#workflow setup#minerva#repo initialization#durable records#gitignore validation
One-click install
npx skills add https://github.com/honerlaw/agent-marketplace --skill init-honerlaw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/honerlaw/agent-marketplace/tree/main/plugins/minerva/skills/init
Command: npx skills add https://github.com/honerlaw/agent-marketplace --skill init-honerlaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents brittle, inconsistent setup of Minerva’s durable record-keeping by creating the required .minerva/ directory layout, wiring routing into the project’s agent file, and ensuring the directories are not accidentally ignored.

Core Features & Use Cases

  • Idempotent scaffolding: Creates .minerva/work/ and .minerva/knowledge/ (with tracked .gitkeep files) and re-runs safely without overwriting existing items.
  • Pre-flight safety checks: Detects and warns about pre-existing flat work/ and decisions/ layouts at the repo root, and about legacy .minerva/decisions/ usage.
  • Gitignore correctness: Verifies .minerva/ is not excluded; ensures .minerva/worktrees/ is ignored on the default branch (appends if needed).
  • Agent routing integration: Adds a ## minerva Routing section to the canonical agent file (CLAUDE.md, AGENTS.md, or GEMINI.md) or prompts you to choose/create an appropriate file.

Quick Start

Run minerva:init to scaffold the .minerva/ layout in the current project and add the required routing section to your agent file.

Frequently Asked Questions about init

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

FAQPage Schema
How do I scaffold durable project records for agent routing in my repository?▼

Project scaffolding for durable records creates the required .minerva/work and .minerva/knowledge directories, adds .gitkeep files for tracking, and wires agent routing into your project's agent file to maintain consistent record-keeping.

What happens if I run repo initialization on a project with pre-existing flat work or decisions folders?▼

Repo initialization performs pre-flight safety checks to detect pre-existing flat work/ and decisions/ folders at the repo root, warning you about legacy layouts without overwriting existing items during the idempotent scaffolding process.

How do I ensure my .minerva worktrees are correctly ignored in git?▼

Gitignore validation checks that .minerva/ is not excluded while ensuring .minerva/worktrees/ is explicitly ignored on the default branch, automatically appending the rule if it is missing to maintain correct repository state.

Can I use agent routing setup with CLAUDE.md, AGENTS.md, or GEMINI.md files?▼

Agent routing setup supports canonical agent files including CLAUDE.md, AGENTS.md, and GEMINI.md by adding a dedicated routing section, or it prompts you to choose and create an appropriate file if none exists.

Is it safe to re-run project scaffolding multiple times on the same repository?▼

Project scaffolding is idempotent, meaning re-running it safely preserves existing items in the .minerva/ directories without overwriting data, making it reliable for repeatable setup across varied project states.

Related Skills

Explore More Software Engineering Skills→
rolopez23rolopez23

initialize

Write or update AGENTS.md and CLAUDE.md with canonical skills references.

Community
Intermediate
honerlawhonerlaw

promote

Promote scratchpad entries into Minerva knowledge while preventing duplicate promotions.

Community
Advanced
not-matthiasnot-matthias
9

worktree-parallel

Create and manage Git worktrees for parallel feature development.

Community
Intermediate
open-gitagentopen-gitagent
2.9k

create-agent

Generate agent.yaml, SOUL.md, and directory structures for new AI agents.

Official
Intermediate