Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-asset-spec
saas-asset-spec
UnverifiedAuthor SVG, icon, and UI asset specifications aligned with PRDs and design tokens.
Running this workflow on this client
Run commands from the project root (use Git Bash on Windows if bash points to an unavailable WSL distro). Shared studio files live in .claude/; follow .agents/PORTABLE-RUNTIME.md and .claude/docs/config-resolution.md for client tools, delegation, and approval rules.
Run bash .claude/hooks/yaml-helper.sh resolve_config --keys locale,review_mode,automation and use its output below.
Asset Spec
Locale & User Profile: Match
locale(pt-BR→ natural Brazilian Portuguese questions/options, overriding English examples;en→ English) anduser_profile(founder→ plain business language with(Recomendado)first, zero tech jargon;developer→ technical). Keep code/tests in English.
The Asset Spec skill produces precise, production-ready specifications for all visual, vector, and media assets required by the SaaS application (brand logos, UI icons, empty-state illustrations, marketing hero graphics, OG social preview cards, and email templates).
If no argument is provided, check whether design/assets/entity-inventory.md exists:
- If it exists: read it, find the first asset or screen with status "Needed" but no spec file yet, and prompt the user.
- If no inventory: check
design/assets/asset-manifest.md. - If neither exists: start the Entity & Screen Inventory flow (Phase 0b below).
Phase 0b: Entity & Screen Inventory (runs when no arguments and no existing inventory)
This flow produces design/assets/entity-inventory.md — the master list of everything
the SaaS application needs visually. Run once before individual asset spec work begins.
Step 1 — Gather from docs
Read all available product design documents:
design/prd/*.md— feature requirements, data tables, empty statesdesign/ux/*.md— screen layouts, user flows, app shelldesign/ui/design-tokens.md— visual foundation, color tokens, typography
Step 2 — Build proposed inventory
Categorize needed assets:
- Brand Assets: Primary logo, dark/light variations, app icon (square, circle), favicon bundle (
favicon.ico,apple-touch-icon.png), social cards (og-image.png). - UI Screens & Components: Dashboard views, settings panels, table views, modal dialogs.
- Empty States & Illustrations: "No projects found", "No invoices yet", "Search returned 0 results", "Invite your team".
- Marketing & Email Media: Feature preview graphics, hero illustrations, transactional email headers.
Step 3 — Write inventory
Write to design/assets/entity-inventory.md.
Phase 0: Parse Arguments
Parse target:
feature:<name>— specify assets for a specific feature (e.g.feature:billing,feature:analytics)screen:<name>— specify assets for a specific screen (e.g.screen:dashboard,screen:onboarding)brand:<name>— specify brand identity assets (e.g.brand:logos,brand:favicons)
Phase 1: Gather Context
Read required design documents:
design/ui/design-tokens.md— color palette, radius, typography, asset budget rulesdesign/product-concept.md— product positioning and tone- Target PRD or UX spec (
design/prd/[name].mdordesign/ux/[name].md)
Phase 2: Asset Identification
List every required asset for the target:
- Format: SVG (vectors, icons, logos), WebP/PNG (illustrations, photos), JSON (Lottie animations)
- Viewport and density targets (1x, 2x for retina displays, responsive mobile)
- Dark mode variant needed? (Yes / No)
Phase 3: Spec Generation
Derive technical specifications and prompt descriptions:
- Dimensions: ViewBox dimensions (e.g.,
24x24for icons,400x300for empty states,1200x630for OG cards). - Color Mapping: Bind SVG fills and strokes to semantic design tokens (
var(--primary),var(--muted-foreground)). - File Size Budget: Max file size in KB (e.g. icon < 5KB, illustration < 50KB, OG image < 200KB).
- Generation Prompt: High-fidelity AI generation prompt (Midjourney, DALL-E, Recraft) if the asset will be procedurally generated.
Phase 4: Compile Spec
Format each asset:
### ASSET-[NNN]: [Asset Name]
- **Type**: Icon | Illustration | Brand | Template
- **Format**: SVG | WebP | PNG
- **Target Path**: `public/assets/[category]/[name].[ext]`
- **Dimensions**: [Width x Height in px / viewBox]
- **Theme Variants**: Light / Dark
- **Size Budget**: [N] KB
- **Design Tokens Used**: `primary`, `card`, `border`
- **Accessibility**: Alt text / ARIA label (`aria-hidden="true"` if decorative)
- **Generation / Design Brief**:
> "[Detailed visual description: composition, palette, lighting, vector style matching design tokens]"
Phase 5: Write Spec File & Manifest
Write to design/assets/specs/[target-name]-assets.md.
Update design/assets/asset-manifest.md with status Specified.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |