convez.ai
SkillDesenvolvimento WebIntermediário
hrhrng

Taste SaaS Skill

hrhrng/taste-saas-skill

Construa consoles SaaS profissionais com estrutura e alinhamento garantidos

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill portátil para Claude/Codex/Cursor que ensina agentes a construir frontends de console SaaS (Linear, Vercel, Notion ou Stripe) com padrões framework-agnósticos. Inclui 4 arquétipos estruturais, 8 knobs de estilo visual, auditoria visual automatizada e componentes prontos como sidebar, datatable, Cmd+K e overlays.

Instalação

$npx convez-ai hrhrng/taste-saas-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar painéis de gerenciamento interno com padrão visual consistente
  • Construir consoles administrativas tipo Linear ou Stripe
  • Auditar alinhamento e drift visual em UIs complexas

Veredito

Skill maduro e especializado para SaaS internos. Força real na padronização estrutural (4 arquétipos), auditoria visual automática e eliminação de anti-patterns. Framework-agnóstico e pronto para produção; exige compreensão de design systems para máxima eficácia.

README

A tradução para o português deste README ainda está na fila.

taste-saas-skill

An agent skill for building internal-tool / management-console style SaaS frontends in one shot.

taste-saas is a portable Claude/Codex/Cursor skill that teaches the agent how to build sidebar-shell SaaS consoles that feel deliberate from the first commit — Linear, Vercel, Notion, or Stripe density depending on the archetype you pick. Sidebar shell, list pages with sticky header + filter chips + server-side filters, wireless detail pages, KPI / chart dashboards, global Cmd+K command palette.

Framework-agnostic patterns. Code samples are in React for clarity; the rules transfer to Vue, Svelte, Solid, vanilla.

Not for marketing pages, landing pages, or storefronts — use taste-skill for those.

Install

npx skills add https://github.com/hrhrng/taste-saas-skill

Single skill by install name:

npx skills add https://github.com/hrhrng/taste-saas-skill --skill "taste-saas"

You can also copy skills/taste-saas/SKILL.md directly into your project, or paste it into a ChatGPT / Codex conversation.

What's in the box

SkillInstall nameWhat it does
taste-saastaste-saasThe full SaaS-console skill: 4 structural archetypes (Linear / Vercel / Notion / Stripe), 8 visual style knobs, wireless tokens, alignment invariants, DataTable mechanics, overlays, Cmd+K, an agent-driven visual layout audit.

The skill includes:

  • SKILL.md — trunk (~120 lines). Workflow, non-negotiables, order of operations.
  • references/ — 20 deep-dive files on archetypes, alignment, tokens, datatable, forms, overlays, sheets, menus, bulk-actions, toast, debug playbook, etc. The trunk points to them in workflow order.
  • audit-overlay.snippet.js — tool-agnostic JS that injects a numbered overlay + alignment grid into the running app. Returns a JSON index with four drift reports (sidebarSlotDrift, mainChromeLeftDrift, mainTextAnchorDrift, crossSeamDrift) and a gridComplexity summary. Paste into chrome-devtool MCP, agent-browser, Playwright, Puppeteer, or the devtools console.
  • check.mjs — relation-based static audit. node ~/.claude/skills/taste-saas/check.mjs <project-root> checks viewport lock, x-axis alignment, sticky thead, etc.

How the skill works

Every taste-saas build picks three things in order:

  1. Structural archetype — pick ONE of 4:

    • A: Floating card on stage (Linear / Cron / Height)
    • B: Flush pane (Vercel / GitHub / Sentry)
    • C: Document workspace (Notion / Linen)
    • D: Enterprise data table (Stripe / Plaid / Retool)

    Decides sidebar bg, main wrapper, breadcrumb location, row style, card chrome.

  2. Visual style knobs — pick values within the archetype's allowed ranges across 8 independent dials (brand hue / saturation / stage tint / surface contrast / radius / type / density / shadow).

  3. Universal mechanics — alignment laws, wireless tokens, DataTable bones, overlay geometry, redundancy hunt. Apply equally to all archetypes.

The biggest historical failure mode was defaulting to Archetype A (Linear floating-card) for every prompt. The skill now requires the agent to ask the user when there's no archetype hint, and includes a built-in audit step so the agent can't ship cross-seam misalignment by accident.

Examples

The examples/ folder shows the same archetype (D-Stripe) built across three skill iterations as the alignment-invariants reference was strengthened. iter-4 ships with icon-x drift; iter-5 fixes that but leaves cross-seam y-drift; iter-7 catches both via the grep audit + verify loop. See examples/progression-report.html.

The 4 archetypes side-by-side (iter-4):

A — LinearB — VercelC — NotionD — Stripe
LinearVercelNotionStripe

Visual layout audit — agent-driven, tool-agnostic

The audit is the part that makes this skill different from "add a rule every time something breaks". The agent runs:

// inject audit-overlay.snippet.js into the running app
window.__taste.run();

Returns JSON with:

  • sidebarSlotDrift — every sidebar icon should share one x. Hint names the offender row when drift detected.
  • mainChromeLeftDrift — chrome row left edges (toolbar, filter bar, pagination) should match.
  • mainTextAnchorDrift — the alignment line your eye actually sees: first text x for page title, filter chips, table thead, first cell. Row borders aren't enough.
  • crossSeamDrift — sidebar first nav row top y ≈ main first chrome row top y.
  • gridComplexity — uniqueX > 15 or uniqueY > 20 means ad-hoc paddings are leaking.

A dashed grid through every coordinate shared by 2+ elements paints over the screenshot. Drift shows up as parallel lines where there should be one. Each item carries text (60-char snippet), className, bbox, firstTextX, and source.file:line from the React fiber (dev build).

License

MIT — see LICENSE.

Acknowledgements

Repository structure inspired by leonxlnx/taste-skill. Skills CLI by vercel-labs/agent-skills.

Ver o original no GitHub

Bom para

Relacionados