fiction — Claude Code skill: what it does, how to install
Generates design system guidelines in a cartoonesque children's book style with cream backgrounds, thick outlines, Cossette Texte typography, and WCAG 2.2 AA checks.
npx skills add bergside/awesome-design-skills --skill fiction -a claude-codeWhat fiction does
This skill instructs your agent to write implementation-ready design system documentation. It enforces the Fiction aesthetic: warm cream backgrounds (#FFE9CE), thick black outlines, and Cossette Texte typography. Surfaces stay flat without drop shadows. Spacing follows a fixed scale from 4 to 32 pixels.
The skill mandates a structured authoring workflow. Component rules must specify anatomy, responsive behavior, and states like focus-visible, loading, or disabled. Accessibility takes priority over aesthetic novelty whenever a conflict appears.
If your project does not license or load the Cossette Texte font, you will need to replace the primary typography token.
What it helps with
- generate design specifications for playful children's-book style UI
- define component interaction states, variants, and responsive layout
- enforce WCAG 2.2 AA accessibility criteria across UI tokens
- create QA acceptance checklists for frontend code reviews
Example prompts for the agent
- Generate component guidelines for a card component using the Fiction design system
- Write a button specification with all interaction states according to Fiction
- Draft QA acceptance criteria for a form input under Fiction WCAG rules
How to install fiction
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill fiction -a claude-code2Manually: put the files in place
~/.claude/skills/fiction/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fiction/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill fiction -a codex2Manually: put the files in place
.agents/skills/fiction/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill fiction -a cursor2Manually: put the files in place
.cursor/skills/fiction/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bergside/awesome-design-skills fiction2Manually: put the files in place
.github/skills/fiction/SKILL.md1Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill fiction -a gemini-cli2Platform CLI
gemini skills install https://github.com/bergside/awesome-design-skills --path skills/fictionManually: put the files in place
.devin/skills/fiction/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bergside/awesome-design-skills --skill fiction -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 fiction
How to install fiction in Claude Code?
Run npx skills add bergside/awesome-design-skills --skill fiction -a claude-code in your terminal. The configuration writes to ~/.claude/skills/fiction/SKILL.md.
What does the fiction skill do?
It formats design system rules around a warm, illustrative aesthetic. The assistant produces token definitions, component anatomy, accessibility criteria, and QA checklists.
Which design tokens does Fiction use?
It uses Cossette Texte for text, JetBrains Mono for code, a 4 to 32 spacing scale, and palette tokens including #FFE9CE secondary and #222222 primary.
Source text
SKILL.md · MIT
--- name: "fiction" description: "A playful, energetic, cartoonesque interface inspired by friendly children's-book illustrations — warm cream backgrounds, big bold custom display typography, saturated brand color blocks, thick black outlines, generously rounded shapes" metadata: author: typeui.sh --- <!-- TYPEUI_SH_MANAGED_START --> # Fiction Design System Skill (Universal) ## Mission You are an expert design-system guideline author for Fiction. Create practical, implementation-ready guidance that can be directly used by engineers and designers. ## Brand A playful, energetic, cartoonesque interface inspired by friendly children's-book illustrations — warm cream backgrounds, big bold custom display typography, saturated brand color blocks, thick black outlines, generously rounded shapes, flat surfaces with almost no shadows, and decorative hand-drawn-feeling illustrations in every section. ## Style Foundations - Visual style: playful - Typography scale: 12/14/16/20/24/32 | Fonts: primary=Cossette Texte, display=Cossette Texte, mono=JetBrains Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900 - Color palette: primary, neutral, success, warning, danger | Tokens: primary=#222222, secondary=#FFE9CE, 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