The AI skill that pairs with unified-mcp.
A Claude Code skill that teaches your AI assistant when and how to use unified-mcp tools. The skill handles judgment, gotchas, and decisions. The MCP server provides the actual data.
unified-skill → tells the AI which MCP tools to call and when
unified-mcp → serves API refs, examples, patterns, and code generation
Neither is useful without the other. Install both.
Covers 9 libraries and domains through a single skill file:
| Domain | Library | What this skill teaches |
|---|---|---|
| Flow UIs | @xyflow/react v12 | Critical gotchas, state decisions, layout choices, custom node/edge patterns |
| Animation | Motion for React v12 | Import rules, AnimatePresence traps, scroll/gesture/spring decisions |
| Smooth scroll | Lenis | GSAP integration, data-lenis-prevent, accessibility, modal locking |
| Frontend | React 19 + Next.js App Router | RSC vs client decisions, state hierarchy, data fetching rules |
| Design system | Tailwind v4 + OKLCH tokens | Three-layer token architecture, @theme vs @theme inline, color ramp rules |
| Web framework | Echo Go | Middleware order, routing, auth, graceful shutdown |
| Backend | Go best practices + design patterns | Error wrapping, goroutine lifecycle, context, concurrency patterns |
| Systems | Rust best practices | Borrow vs clone, error handling, iterator patterns, ownership decisions |
| Design | UI/UX principles | Typography, color, spacing, elevation, motion, accessibility checklists |
The skill does not duplicate API docs - it tells the AI to call the right MCP tool instead, keeping the skill lean and the data always current.
Follow the setup guide at orkait/unified-mcp. You need the MCP server running before this skill does anything useful.
Claude Code - drop into your skills directory:
git clone https://github.com/orkait/unified-skill.git ~/.claude/skills/unified-skillThe skill is picked up automatically on next session start - no config changes needed.
unified-skill/
└── SKILL.md # The full skill - frontmatter triggers + behavioral guidance
The skill has no code. All executable content lives in unified-mcp.
Edit SKILL.md directly. The frontmatter triggers list controls when Claude auto-activates the skill - add terms there if you want it to fire on more keywords.
If you find a gotcha that should be documented, open a PR against this repo. If you find missing API data, open it against unified-mcp.
MIT © Orkait