moai-adk 0.5.4__py3-none-any.whl → 0.5.6__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-cc-agents/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Creating and Managing Sub-agents in Claude Code"
-description: "Design agent personas, define proactive triggers, set tool permissions, structure agent files. Use when building specialized agents for code review, debugging, architecture, or domain-specific tasks."
+name: moai-cc-agents
+description: "Creating and Managing Sub-agents in Claude Code. Design agent personas, define proactive triggers, set tool permissions, structure agent files. Use when building specialized agents for code review, debugging, architecture, or domain-specific tasks."
 allowed-tools: "Read, Write, Edit, Glob, Bash"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When creating or managing sub-agents |
+
+## What It Does
+
+Sub-agent 생성 및 관리를 위한 전체 가이드를 제공합니다. Agent persona 설계, proactive trigger 정의, tool 권한 설정, agent 파일 구조화 방법을 다룹니다.
+
+## When to Use
+
+- Sub-agent를 새로 생성할 때
+- 기존 agent의 권한이나 trigger 조건을 수정할 때
+- Agent 간 협업 패턴을 설계할 때
+- Tool access 최소화 원칙을 적용할 때
+
+
 # Creating and Managing Sub-agents
 
 Sub-agents are specialized Claude instances with independent context, custom prompts, and restricted tool access. They handle deep analysis, parallel work, and autonomous tasks.

moai_adk/templates/.claude/skills/moai-cc-claude-md/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Authoring CLAUDE.md Project Instructions"
-description: "Design project-specific AI guidance, document workflows, define architecture patterns. Use when creating CLAUDE.md files for projects, documenting team standards, or establishing AI collaboration guidelines."
+name: moai-cc-claude-md
+description: "Authoring CLAUDE.md Project Instructions. Design project-specific AI guidance, document workflows, define architecture patterns. Use when creating CLAUDE.md files for projects, documenting team standards, or establishing AI collaboration guidelines."
 allowed-tools: "Read, Write, Edit, Glob"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When authoring CLAUDE.md files |
+
+## What It Does
+
+프로젝트별 CLAUDE.md 파일 작성을 위한 표준 구조와 패턴을 제공합니다. AI 협업 가이드라인, 워크플로우 문서화, 아키텍처 패턴 정의 방법을 다룹니다.
+
+## When to Use
+
+- 새 프로젝트의 CLAUDE.md 파일을 생성할 때
+- 기존 CLAUDE.md를 업데이트하거나 개선할 때
+- 팀 표준 및 개발 워크플로우를 문서화할 때
+- AI 협업 패턴을 정의할 때
+
+
 # Authoring CLAUDE.md Project Instructions
 
 CLAUDE.md is a Markdown file that provides Claude with project-specific context, workflows, standards, and guidance. It acts as a living document for AI collaboration patterns.

moai_adk/templates/.claude/skills/moai-cc-commands/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Designing Slash Commands for Claude Code"
-description: "Create and optimize slash commands with proper argument parsing, tool permissions, and agent orchestration. Use when building workflow entry points, automation commands, or user-facing shortcuts."
+name: moai-cc-commands
+description: "Designing Slash Commands for Claude Code. Create and optimize slash commands with proper argument parsing, tool permissions, and agent orchestration. Use when building workflow entry points, automation commands, or user-facing shortcuts."
 allowed-tools: "Read, Write, Edit, Glob, Bash"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When designing slash commands |
+
+## What It Does
+
+Slash command 설계 및 최적화 방법을 제공합니다. Argument parsing, tool permissions, agent orchestration을 포함한 command 구조를 다룹니다.
+
+## When to Use
+
+- 새로운 slash command를 생성할 때
+- 기존 command를 최적화하거나 리팩토링할 때
+- Workflow entry point를 설계할 때
+- User-facing automation을 구축할 때
+
+
 # Designing Slash Commands
 
 Slash commands are user-facing entry points that orchestrate sub-agents, manage approvals, and coordinate multi-step workflows. They follow the Plan → Execute → Sync cadence.

moai_adk/templates/.claude/skills/moai-cc-hooks/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Configuring Claude Code Hooks System"
-description: "Design, implement, and manage PreToolUse/PostToolUse/SessionStart/Notification/Stop hooks. Use when enforcing safety checks, auto-formatting, running linters, or triggering automated workflows based on development events."
+name: moai-cc-hooks
+description: "Configuring Claude Code Hooks System. Design, implement, and manage PreToolUse/PostToolUse/SessionStart/Notification/Stop hooks. Use when enforcing safety checks, auto-formatting, running linters, or triggering automated workflows based on development events."
 allowed-tools: "Read, Write, Edit, Glob, Bash"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When configuring hook system |
+
+## What It Does
+
+Hook system 설정 및 관리를 위한 전체 가이드를 제공합니다. PreToolUse, PostToolUse, SessionStart 등 다양한 hook type의 설계와 구현 방법을 다룹니다.
+
+## When to Use
+
+- Safety check나 validation hook을 추가할 때
+- Auto-formatting이나 linting을 자동화할 때
+- Session lifecycle event에 응답하는 로직을 작성할 때
+- 개발 이벤트 기반 workflow를 트리거할 때
+
+
 # Configuring Claude Code Hooks System
 
 Hooks are lightweight (<100ms) automated scripts triggered by Claude Code lifecycle events. They enforce guardrails, run quality checks, and seed context without blocking user workflow.

moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Configuring MCP Servers & Plugins for Claude Code"
-description: "Set up Model Context Protocol servers (GitHub, Filesystem, Brave Search, SQLite). Configure OAuth, manage permissions, validate MCP structure. Use when integrating external tools, APIs, or expanding Claude Code capabilities."
+name: moai-cc-mcp-plugins
+description: "Configuring MCP Servers & Plugins for Claude Code. Set up Model Context Protocol servers (GitHub, Filesystem, Brave Search, SQLite). Configure OAuth, manage permissions, validate MCP structure. Use when integrating external tools, APIs, or expanding Claude Code capabilities."
 allowed-tools: "Read, Write, Edit, Bash, Glob"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When setting up MCP servers |
+
+## What It Does
+
+MCP (Model Context Protocol) server 및 plugin 설정을 위한 전체 가이드를 제공합니다. GitHub, Filesystem, SQLite 등 다양한 MCP server의 OAuth 설정, 권한 관리, 구조 검증 방법을 다룹니다.
+
+## When to Use
+
+- 새로운 MCP server를 설정할 때
+- OAuth 인증을 구성할 때
+- External tool이나 API를 통합할 때
+- MCP plugin의 permissions이나 구조를 검증할 때
+
+
 # Configuring MCP Servers & Plugins
 
 MCP servers extend Claude Code with external tool integrations. Each server provides tools that Claude can invoke directly.

moai_adk/templates/.claude/skills/moai-cc-memory/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Managing Claude Code Session Memory & Context"
-description: "Understand session context limits, use just-in-time retrieval, cache insights, manage memory files. Use when optimizing context usage, handling large projects, or implementing efficient workflows."
+name: moai-cc-memory
+description: "Managing Claude Code Session Memory & Context. Understand session context limits, use just-in-time retrieval, cache insights, manage memory files. Use when optimizing context usage, handling large projects, or implementing efficient workflows."
 allowed-tools: "Read, Write, Glob, Bash"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When optimizing context usage |
+
+## What It Does
+
+Session memory 및 context 관리 전략을 제공합니다. Just-in-time retrieval, insight caching, memory file 관리를 통해 context window를 효율적으로 사용하는 방법을 다룹니다.
+
+## When to Use
+
+- Context limit에 도달할 위험이 있을 때
+- 대규모 프로젝트에서 효율적인 context 관리가 필요할 때
+- Session handoff를 준비할 때
+- Memory file 구조를 설계하거나 정리할 때
+
+
 # Managing Claude Code Session Memory & Context
 
 Claude Code operates within context windows (~100K-200K tokens). Effective memory management ensures productive sessions without hitting limits.

moai_adk/templates/.claude/skills/moai-cc-settings/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Configuring Claude Code settings.json & Security"
-description: "Set up permissions (allow/deny), permission modes, environment variables, tool restrictions. Use when securing Claude Code, restricting tool access, or optimizing session settings."
+name: moai-cc-settings
+description: "Configuring Claude Code settings.json & Security. Set up permissions (allow/deny), permission modes, environment variables, tool restrictions. Use when securing Claude Code, restricting tool access, or optimizing session settings."
 allowed-tools: "Read, Write, Edit, Bash"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When configuring security & permissions |
+
+## What It Does
+
+settings.json 설정 및 보안 구성을 위한 전체 가이드를 제공합니다. Permissions (allow/deny), permission modes, environment variables, tool restrictions 설정 방법을 다룹니다.
+
+## When to Use
+
+- 새 프로젝트의 settings.json을 설정할 때
+- Tool access를 제한하거나 보안을 강화할 때
+- Environment variables를 구성할 때
+- Permission mode (ask/allow/deny)를 변경할 때
+
+
 # Configuring Claude Code settings.json
 
 `settings.json` centralizes all Claude Code configuration: permissions, tool access, environment variables, and session behavior.

moai_adk/templates/.claude/skills/moai-cc-skills/SKILL.md

@@ -1,9 +1,29 @@
 ---
-name: "Creating and Optimizing Claude Code Skills"
-description: "Design reusable knowledge capsules with progressive disclosure (metadata → content → resources). Apply freedom levels (high/medium/low), create examples, validate YAML. Use when building domain-specific guidance or automating recurring patterns."
+name: moai-cc-skills
+description: "Creating and Optimizing Claude Code Skills. Design reusable knowledge capsules with progressive disclosure (metadata → content → resources). Apply freedom levels (high/medium/low), create examples, validate YAML. Use when building domain-specific guidance or automating recurring patterns."
 allowed-tools: "Read, Write, Edit, Glob, Bash"
 ---
 
+## Skill Metadata
+
+| Field | Value |
+| ----- | ----- |
+| Version | 1.0.0 |
+| Tier | Ops |
+| Auto-load | When creating or updating Skills |
+
+## What It Does
+
+Claude Code Skill 생성 및 최적화를 위한 전체 가이드를 제공합니다. Progressive disclosure 패턴, freedom level framework, YAML metadata 작성, 예제 구성 방법을 다룹니다.
+
+## When to Use
+
+- 새로운 Skill을 생성할 때
+- 기존 Skill을 최적화하거나 리팩토링할 때
+- Freedom level (high/medium/low) 균형을 조정할 때
+- Skill metadata나 구조를 검증할 때
+
+
 # Creating and Optimizing Claude Code Skills
 
 Skills are modular, reusable knowledge capsules that load via Progressive Disclosure. They combine templates, patterns, and best practices without blocking user workflow.
@@ -31,7 +51,7 @@ skill-name/
 ```yaml
 ---
 name: "Skill Name (Gerund + Domain)"
-description: "[Capability]. Use when [trigger 1], [trigger 2], [trigger 3]."
+description: "Creating and Optimizing Claude Code Skills. [Capability]. Use when [trigger 1], [trigger 2], [trigger 3]."
 allowed-tools: "Read, Write, Bash(python:*)"
 ---
 ```
@@ -129,7 +149,7 @@ if __name__ == "__main__":
 **Level 1**: Metadata (always loaded)
 ```yaml
 name: "Database Query Optimization"
-description: "Profile slow queries, analyze execution plans, suggest indexes..."
+description: "Creating and Optimizing Claude Code Skills. Profile slow queries, analyze execution plans, suggest indexes..."
 allowed-tools: "Read, Bash(sqlite3:*)"
 ```
 
@@ -164,7 +184,7 @@ data cleaning, validation, or transformation."
 ```yaml
 ---
 name: "Testing React Components with Vitest"
-description: "Write unit tests for React components, mock hooks, test async behavior. Use when testing React components, setting up Vitest, or debugging test failures."
+description: "Creating and Optimizing Claude Code Skills. Write unit tests for React components, mock hooks, test async behavior. Use when testing React components, setting up Vitest, or debugging test failures."
 allowed-tools: "Read, Write, Bash(npm:*), Bash(npm run:*)"
 ---