Agent skill
design-intent-specialist
Creates accurate frontend implementations from visual references while maintaining design consistency. Use when user provides Figma URLs, screenshots, design images, requests visual implementation from reference, or asks to build UI matching a design. Automatically checks existing design intent patterns before implementation.
Install this agent skill to your Project
npx add-skill https://github.com/joaquimscosta/arkhe-claude-plugins/tree/main/plugins/design-intent/skills/design-intent-specialist
SKILL.md
Design Intent Specialist
Create accurate frontend implementations from visual references while maintaining design consistency.
Core Philosophy: Visual fidelity first, with intelligent conflict resolution when references clash with existing patterns.
Quick Start
1. Check Existing Patterns (Mandatory)
Before any implementation:
- Read
/design-intent/patterns/directory - Report: "Existing patterns to consider: [list with values]"
- Understand established design decisions
2. Analyze Visual Reference
- Extract visual elements for implementation
- Identify potential conflicts with existing patterns
- Plan implementation approach
3. Implement with Conflict Resolution
When visual references conflict with existing design intent:
- Implement the reference faithfully - This is what the user requested
- Flag conflicts clearly - "This design uses 8px spacing, but our intent specifies 12px"
- Ask for guidance - "Should I follow the design exactly, or adapt to established spacing?"
- Suggest implications - "If we use this spacing, should it become our new standard?"
4. Section-by-Section Implementation
For complex designs, break down into:
- Header: Navigation, branding, user controls
- Navigation: Menu items, hierarchies, states
- Main Content: Primary content, data display, forms
- Footer: Secondary links, metadata, actions
Each section analyzed for: layout, spacing, typography, responsiveness, visual treatment.
Implementation Priority
- Visual fidelity - Match the reference closely
- Existing components - Use established components where they fit
- Framework components - Leverage Fluent UI when appropriate
- Custom components - Create only when necessary for design accuracy
Custom Components
When creating custom components, use clear naming (CustomCard vs Card) and document with header comments. See WORKFLOW.md - Custom Component Documentation for the documentation template.
Behavioral Rules
- ALWAYS check existing design intent first - non-negotiable
- Visual fidelity over strict consistency - implement what's requested, flag conflicts
- Ask for guidance on conflicts - don't assume precedence
- Track custom components - for maintainability
MCP Integration
Optional: figma-dev-mode-mcp-server (Figma extraction) and fluent-pilot (Fluent UI guidance). Works without MCPs using screenshots.
Reference Documentation
- Detailed workflow: See WORKFLOW.md
- Usage examples: See EXAMPLES.md
- Common issues: See TROUBLESHOOTING.md
Invocation
Triggered by:
- Phase 5 of
/design-intentworkflow (automatic invocation) - User providing Figma URLs or screenshots
- Requests to implement UI from visual references
Workflow Integration
When invoked from /design-intent Phase 5, architecture decisions and exploration are complete. Focus on execution with the richer context provided by the structured workflow.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
Skill Name
What this skill does. Use when user mentions "keyword1", "keyword2", or "keyword3". Keep under 1,024 characters and include specific trigger keywords.
plugin-release-checker
skill-validator
Validate skills against Anthropic best practices for frontmatter, structure, content, file organization, hooks, MCP, and security (62 rules in 8 categories). Use when creating new skills, updating existing skills, before publishing skills, reviewing skill quality, or when user mentions "validate skill", "check skill", "skill best practices", "skill review", or "lint skill".
sync-docs
Sync official Anthropic documentation and analyze impact on project components. Runs docs/reference/update-claude-docs.sh, computes diffs, and reports impacts on the skill validator, plugins, and project documentation. Use when user mentions "sync docs", "update reference docs", "refresh docs", or "check doc changes".
research-frontmatter
Enforce standard YAML frontmatter on research documents in docs/research/. Use when creating, editing, or promoting research files, when user mentions "research metadata", "research frontmatter", or "research staleness".
deep-research
Deep research on technical topics using EXA tools with intelligent two-tier caching. Use when user asks to research a topic, investigate best practices, look up information, find patterns, or explore architectures. Also invoked by /research command. Triggers: "research", "look up", "investigate", "deep dive", "find information about", "what are best practices for", "how do others implement".
Didn't find tool you were looking for?