write-art-bible

Writes or updates a project art bible document from repository evidence and user interview.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill write-art-bible-sagittaras
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-art-bible
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/write-art-bible
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill write-art-bible-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Visual style decisions in a project often live scattered across code, config files, and people's heads, so interfaces get built inconsistently. This Skill produces a single authoritative art bible document whose every value is either extracted from the codebase or confirmed by the user — never invented. ## Core Features & Use Cases - Repository mining: Extracts existing color tokens, fonts, components, styling ADRs, and asset conventions from the project before asking any questions. - Guided interview with approval gate: Asks only about what the repo cannot answer (intent, mood, references, repeated failures), then requires an approved outline before writing anything. - Computed contrast ratios: Calculates WCAG contrast ratios via an awk script instead of estimating them, and records unverifiable values as open questions with owners. - Use Case: A team complains that every generated screen looks different and gray. Run this Skill to mine the Tailwind config and component library, interview the design owner, and produce a versioned art bible with hard rules, token mappings, and accessibility thresholds. ## Quick Start Ask the agent to write an art bible for this project based on the existing design tokens and components.

Frequently Asked Questions about write-art-bible

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an art bible for my project?

Invoke the skill with an optional topic or path to an existing art bible. It first mines your repository for tokens, fonts, and components, then interviews you about intent and references, and writes the document only after you approve the outline.

How does the skill handle existing style guides or design system docs?

It searches for existing documents under names like art-bible, style-guide, design-system, or brand, including nested documentation folders. Found documents are presented in the interview so you choose between updating them or creating a new cross-referenced document.

Does the skill invent design values it cannot find?

No. Values without support in code or a confirmed user answer are recorded as open questions with an owner and deadline. The skill refuses to write the document at all if the user interview cannot take place.

How are WCAG contrast ratios calculated?

Contrast ratios are computed with an awk script implementing the WCAG relative luminance formula, not estimated visually. Colors in oklch, hsl, or rgb are converted to hex first, and pairs that cannot be reliably converted become open questions.

When should I not use the art bible skill?

Do not use it for single-screen specs (use write-ux-spec), styling technology decisions (use write-adr), enforceable rules in .claude/rules (use write-rule), or actual code implementation of the visual design, which is handled through issues.