Skill Management

Skill Design Principles

1. SKILL.md is Self-Contained

• Contains ALL information needed to use the skill
• Should be as minimal as possible while conveying complete information
• No need for separate README, USAGE, INSTALL, or CHANGELOG files

2. Single Script Design

• Optimize for ONE script per skill (not multiple scripts)
• Use command-line parameters for different operations
• Pattern: ./script.sh <command> [arguments]

3. Minimal File Structure

skill-name/
├── SKILL.md          # Required - complete documentation
└── script.sh         # Optional - single CLI if needed

SKILL.md Structure

Required frontmatter:

---
name: skill-name
description: What it does and when to use it. Use when [triggers].
version: 1
---

Creating a New Skill

1. Create directory in .claude/skills/skill-name/
2. Create SKILL.md with frontmatter and documentation
3. Optionally add a shell script for automation
4. Make scripts executable with chmod +x

Rendering Custom UI

For rendering interactive HTML interfaces in chat, use the create-interface skill which provides comprehensive documentation on the mcp__noetect-ui__render_ui tool.