Menú
Use when starting a new project or initializing Matilha in an existing one — scaffolds project-status.md, AGENTS.md, CLAUDE.md/GEMINI.md, and phase 0 artifacts.
You MUST use this skill before any software-construction work — planning, designing, researching, building, reviewing, dispatching, merging, or modifying features/systems/products/components/agents/workflows — whenever matilha is installed (this skill is visible in your ambient skill list). Matilha is a methodology wrapper around superpowers:* skills; compose routes user intent to the right matilha phase (scout/plan/design/hunt/gather/review/howl) or dispatches to superpowers:brainstorming with pack-aware preamble. Runs standalone when superpowers is absent. Detects companion packs (matilha-*-pack namespace) as optional enrichment. Lazy-bootstraps matilha project structure on demand.
Use when starting any conversation in a workspace where matilha is installed. Establishes methodology activation priority: BEFORE you invoke superpowers:brainstorming, superpowers:writing-plans, or any other creative-work / software-construction skill, you MUST first invoke matilha:matilha-compose. Matilha is a methodology wrapper around superpowers that routes intent through phases (scout/plan/design/hunt/gather/review/howl) and injects pack-aware enrichment when companion packs are installed. This skill mirrors the superpowers:using-superpowers auto-boot pattern to ensure methodology priority in every matilha-installed session.
Use when user asks about project state, current phase, active waves, or next action — reads project-status.md and surfaces the status in a stream-friendly format.
Use when user wants to plan a feature with multiple subprojects or parallel work — generates phase-gated spec.md and plan.md with waves, SPs, merge_order, and exit gates.
Use when user is in Phase 10 discovery for a feature — runs parallel research subagents and produces a research markdown that feeds matilha-plan.
Use when user is making UX, UI, or visual-design decisions in any phase — guides via core design heuristics and delegates to matilha-design-pack or matilha-ux-pack if installed.
| name | matilha-init |
| description | Use when starting a new project or initializing Matilha in an existing one — scaffolds project-status.md, AGENTS.md, CLAUDE.md/GEMINI.md, and phase 0 artifacts. |
| category | matilha |
| version | 1.0.0 |
| optional_companions | [] |
User is at the start of a project (no project-status.md) or wants to bootstrap Matilha into an existing codebase. The skill scaffolds the minimum artifacts for Matilha to work: project-status.md with initial phase 0 state, CLAUDE.md / AGENTS.md / GEMINI.md as context primers, and the directory scaffold (docs/matilha/, docs/superpowers/).
project-status.md unless user explicitly confirms overwrite.test -f project-status.md. If present and user didn't say "force", ask the user before overwriting.archetype (one of: saas-b2b, saas-b2c, frontend-only, cli, library, ml-service, marketplace).date -u +%Y-%m-%dT%H:%M:%SZ.project-status.md via Write tool. Frontmatter shape: schema_version: 1, name, archetype, created: <iso>, last_update: <iso>, current_phase: 0, phase_status: not_started, next_action: "Run /matilha-scout to enter Phase 10 discovery.", tools_detected: [], companion_skills: {impeccable: not_installed, shadcn: not_installed, superpowers: not_installed, typeui: not_installed}, active_waves: [], completed_waves: [], feature_artifacts: [], recent_decisions: [], pending_decisions: [], blockers: [], aesthetic_direction: null, design_locked: false.CLAUDE.md / AGENTS.md / GEMINI.md if absent (copy from this repo's templates if available via matilha pull, else from skeletons).docs/matilha/plans, docs/matilha/specs, docs/matilha/waves via Bash mkdir -p.project-status.md without explicit user confirmation.On success, user has a Matilha-initialized project with the 3 context files + project-status.md. Next skill the user invokes is typically matilha-scout (Phase 10) or matilha-plan (Phase 20-30) if they already have research.
project-status.md exists with valid frontmatter (conforms to projectStatusSchema).docs/matilha/ directory tree exists.matilha-howl next and see phase 0 state.No companion integrations in Wave 4a. Future packs may extend this skill.
project-status.mdCLAUDE.md (if absent)AGENTS.md (if absent)GEMINI.md (if absent)docs/matilha/plans/docs/matilha/specs/docs/matilha/waves/projectStatusSchema; ISO-UTC timestamps.saas-b2b, saas-b2c, frontend-only, cli, library, ml-service, marketplace; ask user to pick from the list.If matilha CLI is installed (
matilha --versionsucceeds), you can runmatilha initto execute this deterministically. The plugin path above works without any CLI installation.