doodle — Claude Code skill: what it does, how to install
This skill sets a playful doodle style for interface guidance with handwritten fonts, sketches, and imperfect lines. Use it when shaping a design system or UI guide.
npx skills add bergside/awesome-design-skills --skill doodle -a claude-codeWhat doodle does
doodle helps an agent write practical design-system guidance in a playful, informal style. It defines typography with Delius Swash Caps and JetBrains Mono, color tokens, a spacing scale, and rules for visual hierarchy. It also covers component states and interaction through keyboard, pointer, and touch input.
The skill includes a workflow for producing a guide: state the goals, define tokens, describe components, add accessibility criteria, set content tone, list anti-patterns, and finish with a QA checklist. Its accessibility rules call for WCAG 2.2 AA, keyboard-first interactions, and visible focus states. If a project already uses different typography, check how Delius Swash Caps fits before applying the rules.
It prefers semantic tokens over raw values and asks for explicit states such as default, hover, focus-visible, active, disabled, loading, and error when relevant.
What it helps with
- define color, typography, and spacing tokens
- document component anatomy and states
- set testable accessibility criteria for UI
- create a QA checklist for code review
- align content tone with visual hierarchy
Example prompts for the agent
- Use the
doodleskill to write a design-system guide for this interface. - Create a
doodlebutton guide with tokens, states, keyboard behavior, and WCAG 2.2 AA acceptance criteria. - Review the existing components against
doodle, then add anti-patterns and migration guidance.
How to install doodle
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill doodle -a claude-code2Manually: put the files in place
~/.claude/skills/doodle/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/doodle/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill doodle -a codex2Manually: put the files in place
.agents/skills/doodle/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill doodle -a cursor2Manually: put the files in place
.cursor/skills/doodle/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bergside/awesome-design-skills doodle2Manually: put the files in place
.github/skills/doodle/SKILL.md1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill doodle -a gemini-cli2Platform CLI
gemini skills install https://github.com/bergside/awesome-design-skills --path skills/doodleManually: put the files in place
.devin/skills/doodle/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill doodle -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about doodle
How do I install doodle in Claude Code?
Run npx skills add bergside/awesome-design-skills --skill doodle -a claude-code, then run npx skills add bergside/awesome-design-skills --skill doodle -a claude-code again. The skill file is at ~/.claude/skills/doodle/SKILL.md.
What does doodle do?
It helps an agent write design-system guidance for a playful, hand-drawn interface style. The skill covers tokens, components, states, accessibility, and a QA checklist.
What accessibility requirements does doodle define?
It calls for WCAG 2.2 AA, keyboard-first interactions, and visible focus states. The requirements are intended to be testable in implementation.
Source text
SKILL.md · MIT
--- name: doodle description: Hand-drawn, sketch-like style with doodles, handwritten fonts, and imperfect lines for a playful, informal feel. license: MIT metadata: author: typeui.sh --- <!-- TYPEUI_SH_MANAGED_START --> # Doodle Design System Skill (Universal) ## Mission You are an expert design-system guideline author for Doodle. Create practical, implementation-ready guidance that can be directly used by engineers and designers. ## Brand a creative, playful, and informal style that utilizes doodles, sketches, handwritten fonts, and imperfect lines to foster emotional connection and a raw, artistic feel ## Style Foundations - Visual style: playful - Typography scale: 14/16/18/24/32/40 | Fonts: primary=Delius Swash Caps, display=Delius Swash Caps, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900 - Color palette: primary, secondary, neutral, success, warning, danger | Tokens: primary=#49B6E5, secondary=#263D5B, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827 - Spacing scale: 4/8/12/16/24/32 ## Accessibility WCAG 2.2 AA, keyboard-first interactions, visible focus states ## Writing Tone concise, confident, helpful ## Rules: Do - prefer semantic tokens over raw values - preserve visual hierarchy - keep interaction states explicit ## Rules: Don't - avoid low contrast text - avoid inconsistent spacing rhythm - avoid ambiguous labels ## Expected Behavior - Follow the foundations first, then component consistency. - When uncertain, prioritize accessibility and clarity over novelty. - Provide concrete defaults and explain trade-offs when alternatives are possible. - Keep guidance opinionated, concise, and implementation-focused. ## Guideline Authoring Workflow 1. Restate the design intent in one sentence before proposing rules. 2. Define tokens and foundational constraints before component-level guidance. 3. Specify component anatomy, states, variants, and interaction behavior. 4. Include accessibility acceptance criteria and content-writing expectations. 5. Add anti-patterns and migration notes for existing inconsistent UI. 6. End with a QA checklist that can be executed in code review. ## Required Output Structure When generating design-system guidance, use this structure: - Context and goals - Design tokens and foundations - Component-level rules (anatomy, variants, states, responsive behavior) - Accessibility requirements and testable acceptance criteria - Content and tone standards with examples - Anti-patterns and prohibited implementations - QA checklist ## Component Rule Expectations - Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant). - Describe interaction behavior for keyboard, pointer, and touch. - State spacing, typography, and color-token usage explicitly. - Include responsive behavior and edge cases (long labels, empty states, overflow). ## Quality Gates - No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example. - Every accessibility statement must be testable in implementation. - Prefer system consistency over one-off local optimizations. - Flag conflicts between aesthetics and accessibility, then prioritize accessibility. ## Example Constraint Language - Use "must" for non-negotiable rules and "should" for recommendations. - Pair every do-rule with at least one concrete don't-example. - If introducing a new pattern, include migration guidance for existing components. <!-- TYPEUI_SH_MANAGED_END -->
© typeui.sh · MIT · bergside/awesome-design-skills