build-moat-assets

Creates MOAT directory structures and populates skill asset files from spec packages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Building plugin skills by hand means manually creating directories, writing SKILL.md files, and populating references, examples, prompts, scripts, and assets — a repetitive process prone to empty folders, missing permissions, and inconsistent structure. This Skill automates the physical disk operations that turn a spec package into a complete, verified skill directory. ## Core Features & Use Cases - Directory Scaffolding: Creates skill directories and only the MOAT subdirectories (references/, examples/, prompts/, scripts/, assets/) that have actual content, avoiding empty folders. - File Population with Verification: Writes SKILL.md and asset files from the spec package, then verifies existence, JSON validity, markdown headers, and script shebangs with executable permissions. - Safe Overwrite Handling: Detects existing skill directories, warns the user, and backs up existing SKILL.md files before overwriting. - Use Case: You have a spec package defining three new skills for a Claude Code plugin. Run this Skill to generate all directories, write every asset file, set script permissions, and receive a summary table of files created, lines written, and any warnings. ## Quick Start Build the MOAT asset directories and files for all skills defined in my spec package at specs/my-plugin into the target plugin at plugins/my-plugin.

Frequently Asked Questions about build-moat-assets

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

FAQPage Schema
How do I create skill directory structures for a Claude Code plugin?▼

Provide a spec package path and target plugin path. The Skill reads the spec, creates skills/{skill-name}/ directories, writes SKILL.md files, and populates only the MOAT subdirectories that have content, then verifies every file created.

What are MOAT assets in plugin skill development?▼

MOAT assets are the supporting files in a skill's subdirectories: references/ for domain knowledge, examples/ for input-output samples, prompts/ for reusable prompt templates, scripts/ for executable automation, and assets/ for templates and static files.

Does it overwrite existing skill directories?▼

No, not silently. If a skill directory already exists, it lists the current contents and waits for user confirmation. When confirmed, it backs up the existing SKILL.md as SKILL.md.bak before overwriting.

Why do my skill scripts fail with bad interpreter errors?▼

Scripts with Windows line endings (\r\n) break shebang lines on Unix systems. This Skill detects and converts line endings, adds correct shebangs for .sh, .py, and .js files, and sets executable permissions with chmod +x.

What happens if the spec package is missing content for some subdirectories?▼

Subdirectories without content in the spec package are simply not created. The Skill never generates empty directories, and a skill with only a SKILL.md file is reported as a valid minimal build.