moai-foundation-cc

Guides creation of Claude Code skills, sub-agents, plugins, slash commands, and hooks.

2|Updated May 27, 2026
One-click install
npx skills add https://github.com/yekinya/moai-novel --skill moai-foundation-cc-yekinya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-foundation-cc
Source: https://github.com/yekinya/moai-novel/tree/main/moai-novel/.claude/skills/moai-foundation-cc
Command: npx skills add https://github.com/yekinya/moai-novel --skill moai-foundation-cc-yekinya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building Claude Code extensions requires knowing many scattered configuration formats—skill frontmatter, agent definitions, plugin manifests, hook events, settings hierarchies—and getting any of them wrong silently breaks behavior. This Skill consolidates the official authoring rules into one reference so extensions are created correctly the first time. ## Core Features & Use Cases - Extension Authoring Reference: Covers Skills, sub-agents, plugins, slash commands, hooks, memory, settings, sandboxing, headless mode, and dev containers with official documentation excerpts. - Advanced Agent Patterns: Documents two-agent long-task patterns, orchestrator-worker architectures, context engineering, and tool design best practices from Anthropic engineering guidance. - Validation Guardrails: Includes rationalization tables, red flags, and a verification checklist (e.g., CLAUDE.md under 40K characters, CSV allowed-tools format, hook timeout requirements). - Use Case: When asked to create a new Claude Code skill or configure a PreToolUse hook, this Skill supplies the exact frontmatter format, directory structure, and common pitfalls to avoid. ## Quick Start Ask the agent to create a new Claude Code skill or sub-agent and it will apply the official format rules and validation checklist from this reference.

Frequently Asked Questions about moai-foundation-cc

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

FAQPage Schema
How do I create a Claude Code skill?

Create a SKILL.md file with YAML frontmatter containing a kebab-case name and a third-person description under 1024 characters. Keep the body under 500 lines, use progressive disclosure with reference files, and declare allowed-tools as a comma-separated list.

How do I configure hooks in Claude Code settings.json?

Add a hooks object keyed by event name such as PreToolUse or PostToolUse, each containing matcher patterns and command entries. Always set an explicit timeout, use $CLAUDE_PROJECT_DIR instead of absolute paths, and ensure every registered hook has a matching script file.

What is the difference between Claude Code skills and sub-agents?

Skills are model-invoked instruction sets loaded via progressive disclosure, while sub-agents are specialized assistants with their own 200K context window invoked via the Agent tool. Sub-agents cannot spawn other sub-agents and handle all user interaction before delegation.

Can Claude Code run headless in CI/CD pipelines?

Yes, use the -p flag for non-interactive execution combined with --allowedTools to restrict capabilities and --output-format json for parseable results. Always validate inputs and check exit codes for error handling in automated environments.

Why is my Claude Code skill not triggering correctly?

Common causes include a missing or vague description field, space-separated instead of comma-separated allowed-tools, or disabled progressive disclosure on oversized skills. Verify the frontmatter uses quoted string values and includes trigger keywords users actually mention.