Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-asset-spec

saas-asset-spec

Unverified

Author SVG, icon, and UI asset specifications aligned with PRDs and design tokens.

FileKindSize
SKILL.mdskill md5.1 KB
---
name: saas-asset-spec
description: "Author SVG, icon, and UI asset specifications aligned with PRDs and design tokens."
argument-hint: "[feature:<name> | screen:<name> | brand:<name>] [--review full|lean|solo]"
user-invocable: true
---

<!-- Generated from .claude/skills by scripts/sync-agent-skills.py. -->

## 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) and `user_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 states
- `design/ux/*.md` — screen layouts, user flows, app shell
- `design/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:
1. `design/ui/design-tokens.md` — color palette, radius, typography, asset budget rules
2. `design/product-concept.md` — product positioning and tone
3. Target PRD or UX spec (`design/prd/[name].md` or `design/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., `24x24` for icons, `400x300` for empty states, `1200x630` for 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:

```markdown
### 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`.
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall