plan-moat-strategy

Plan MOAT asset allocation for plugin skills based on complexity scoring.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill plan-moat-strategy-javimontano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-moat-strategy
Source: https://github.com/JaviMontano/mao-plugin-qa/tree/main/skills/plan-moat-strategy
Command: npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill plan-moat-strategy-javimontano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deciding which supporting files (references, examples, prompts) each skill in a Claude Code plugin needs is often arbitrary, leading to bloated or under-resourced skills. This Skill provides a structured, score-based method to allocate MOAT (Materials, Ontology, Assets, Templates) assets per skill. ## Core Features & Use Cases - Complexity Scoring: Rates each skill across four dimensions (domain knowledge, procedure steps, edge cases, user interaction) to produce a LOW to VERY HIGH complexity score. - Depth Allocation: Maps complexity scores to MOAT depths (MINIMAL, STANDARD, FULL, DEEP) with override rules for spec-referencing or artifact-producing skills. - Asset Planning: Defines naming conventions, file purposes, and line-count estimates for references/, examples/, and prompts/ directories, then compiles everything into a moat-strategy.md document. - Use Case: After drafting an architecture plan for a new plugin, run this Skill to decide that a hook-validation skill needs a compatibility matrix reference and examples, while a simple utility skill needs only its SKILL.md. ## Quick Start Plan the MOAT strategy for my plugin using the architecture plan at docs/architecture-plan.md.

Frequently Asked Questions about plan-moat-strategy

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

FAQPage Schema
How do I plan supporting assets for Claude Code plugin skills?▼

Score each skill across four dimensions (domain knowledge, procedure steps, edge cases, user interaction), then map the total to a MOAT depth: MINIMAL, STANDARD, FULL, or DEEP. The depth determines whether the skill needs references/, examples/, and prompts/ subdirectories.

What is MOAT depth in plugin skill design?▼

MOAT depth defines how many supporting asset directories a skill needs. MINIMAL is SKILL.md only, STANDARD adds references/, FULL adds examples/, and DEEP adds prompts/. Depth is derived from a 4-12 complexity score.

When should a skill include a references directory?▼

A skill needs references/ when it scores MEDIUM complexity or higher, or when it cites external specifications or standards regardless of score. Reference files follow the {topic}-{type}.md naming convention with types like spec, guide, matrix, patterns, or framework.

Does this skill create the MOAT asset files?▼

No, it only produces a strategy document (moat-strategy.md) with the allocation plan, naming conventions, and line estimates. The actual directories and content are created by the separate build-moat-assets skill.

What are the limitations of complexity-based MOAT scoring?▼

The four-dimension scoring is heuristic, so two skills with identical scores may need different assets. Line estimates assume standard markdown density, and the override rules are PQA conventions rather than official spec requirements.