agentleFS
bogdanbaciu21bogdanbaciu21/skills/bogdan-baciu-design/SKILL.md

bogdan-baciu-design

Skill2 starsChanged 4 months agoMITView on GitHub

Apply Bogdan Baciu's personal editorial design system to websites, static HTML, prototypes, documents, slide decks, and financial-model artifacts. Use when the user asks for "Bogdan brand", "my brand", "personal branding", "brand this", "apply the design system", "rebrand this", "make this look like bogdanbaciu.com", or when building/reviewing bogdanbaciu.com-facing interfaces. Includes the Puddles sky-blue on warm-cream palette, Instrument Serif + Geist + JetBrains Mono typography, flat editorial layout rules, and the scoped .db-scope financial-artifact styling.

The file

Show its rules and text

We split this skill into the rules it gives an agent

28 rules. About 0 are common, 14 are distinctive, and 14 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈14

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 14

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Very specific:

    Use fixtures/brand-regression/*.html as visual regression fixtures when checking that the global brand and .db-scope financial-artifact …

    line 23
  2. Very specific:

    Use fixtures/brand-regression/screenshot-contract.json as the browser screenshot checklist for those fixtures.

    line 26
  3. Very specific:

    Use reskin.example.json as the compatibility example when wiring this brand into the reskin skill.

    line 29
  4. Very specific:

    Keep financial-model artifacts inside .db-scope or a clearly equivalent local scope.

    line 51
  5. Very specific:

    Prefer the existing token names and component classes before inventing new CSS.

    line 54
  6. Distinctive:

    use exact hex approximations where the target cannot use OKLCH

    line 57
  7. Distinctive:

    use available font fallbacks when self-hosted fonts are impossible

    line 58
  8. Distinctive:

    keep the same hierarchy, spacing, and palette separation

    line 59
  9. Very specific:

    Verify the result. For web work, inspect across mobile and desktop widths, check text wrapping, confirm assets load, and confirm .db-scope …

    line 60
  10. Very specific:

    Before final delivery, scan for unresolved TBU placeholders in the output artifact.

    line 64
  11. Distinctive:

    Use one global accent: sky-blue.

    line 73
  12. Very specific:

    Default radius is sharp 2px.

    line 75
  13. Distinctive:

    When a layout feels cramped, widen the container before shrinking the type.

    line 83
  14. Distinctive:

    When applying this skill, report:

    line 87
  15. Distinctive:

    When editing packaged tokens, fixtures, or the reskin example, run:

    line 97
  16. Distinctive:

    Do not author the owner's public voice from scratch.

    line 110
  17. Very specific:

    Do not merge the global and .db-scope palettes.

    line 111
  18. Distinctive:

    Do not add a broad icon library, theme gradient, or shadow language unless the target repo already requires it.

    line 112
  19. Distinctive:

    Do not replace a repo's existing production design system without first mapping the Bogdan tokens onto its local conventions.

    line 114
  20. Very specific:

    Use assets/design-system/colors_and_type.css and self-host the fonts/ directory next to the artifact if it must open from disk.

    line 124
  21. Distinctive:

    Keep the global page in the Puddles paper/sky system.

    line 126
  22. Very specific:

    Put any dense table or operating-model exhibit inside .db-scope.

    line 127
  23. Very specific:

    Run the repo's brand_lint.py when present, then inspect mobile and desktop widths for overflow.

    line 128
  24. Very specific:

    Do not apply this skill directly.

    line 139
  25. Distinctive:

    Use Instrument Serif for the main title, Geist for body/UI text, and JetBrains Mono for labels or provenance lines.

    line 149
  26. Distinctive:

    Keep depth flat: borders, rules, spacing, no global shadows or gradients.

    line 151
  27. Distinctive:

    Use the global brand for the page shell.

    line 159
  28. Very specific:

    Use .db-scope only around the model exhibit.

    line 160

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Bogdan Baciu Design

Apply Bogdan Baciu's editorial personal-site brand to digital artifacts while preserving the user's content and judgment. The brand should feel like a hand-finished finance/technology editorial surface: warm paper, a single sky-blue accent, display serif headlines, restrained mono chrome, flat borders, and dense but readable financial exhibits.

Source files

  • Load references/brand-system.md when you need detailed rules, artifact-mode guidance, or a compact token summary.
  • Copy from assets/design-system/colors_and_type.css for web/static HTML work.
  • Copy assets/design-system/fonts/ when the output can self-host fonts.
  • Copy imagery, favicons, logos, previews, or UI kits from assets/design-system/assets/, preview/, and ui_kits/ only when the artifact actually needs them.
  • Use fixtures/brand-regression/*.html as visual regression fixtures when checking that the global brand and .db-scope financial-artifact styling still render separately.
  • Use fixtures/brand-regression/screenshot-contract.json as the browser screenshot checklist for those fixtures; it stays public-safe and stores selectors/expectations instead of private screenshots.
  • Use reskin.example.json as the compatibility example when wiring this brand into the reskin skill.

Provenance

  • Brand source: local Bogdan-Baciu-Design-System repo.
  • Packaging pattern: adapted from the official Anthropic brand-guidelines skill's compact palette/type/fallback approach; brand values and rules here are Bogdan-specific.

Workflow

  1. Identify the artifact type: website/static HTML, app UI, slide deck, document, data table, or financial-model exhibit.
  2. Preserve the user's substantive content. Do not invent public-facing body copy; use TBU for missing prose.
  3. Apply the global brand outside financial exhibits:
    • warm cream paper, ink text, Puddles sky-blue accent
    • Instrument Serif for display and ledes
    • Geist for body/UI
    • JetBrains Mono for eyebrows, chips, chrome, code, and utility labels
    • flat borders and hairlines, not shadows
  4. Keep financial-model artifacts inside .db-scope or a clearly equivalent local scope. Do not let .db-scope colors, shadows, or typography leak into the global site brand.
  5. Prefer the existing token names and component classes before inventing new CSS. For tables, prefer div.bbt-wrap + table.bbt.
  6. Translate the brand carefully for non-web artifacts:
    • use exact hex approximations where the target cannot use OKLCH
    • use available font fallbacks when self-hosted fonts are impossible
    • keep the same hierarchy, spacing, and palette separation
  7. Verify the result. For web work, inspect across mobile and desktop widths, check text wrapping, confirm assets load, and confirm .db-scope stays scoped. For decks/docs, inspect rendered output rather than trusting source formatting alone.
  8. Before final delivery, scan for unresolved TBU placeholders in the output artifact. TBU is acceptable while drafting missing owner-authored copy; it must be reported explicitly and should not remain in a final publishable file unless the user approves the gap.

Core rules

  • Two palettes coexist. Global Puddles governs normal brand surfaces; .db-scope governs embedded financial-model artifacts only.
  • Use one global accent: sky-blue. Rust is reserved for text selection and focus treatment, not general fills or calls to action.
  • Default radius is sharp 2px. The only general radii are sharp 2px, card 16px, and pill 999px.
  • Body prose is justified with soft hyphenation where the medium supports it. Headings use balanced wrapping; long ledes use justified/pretty wrapping.
  • Depth comes from borders, rules, tables, and spacing. Avoid global shadows, glassmorphism, gradients, decorative blobs, and stock-looking decoration.
  • Icons are sparse. Use existing logos/assets or restrained utility icons only when the interface needs them.
  • When a layout feels cramped, widen the container before shrinking the type.

Output contract

When applying this skill, report:

  • which source files/assets were used
  • any token, font, image, or icon substitutions
  • whether .db-scope was used
  • any unresolved TBU placeholders and why they remain
  • which checks were run or which rendered surfaces were inspected

Skill maintenance checks

When editing packaged tokens, fixtures, or the reskin example, run:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_token_integrity.py
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest tests/test_brand_fixtures.py

The token checker protects the core palette/type/font contract; the fixture test protects the public-safe screenshot contract and the reskin.example.json manifest shape.

What this skill does not do

  • Do not author the owner's public voice from scratch.
  • Do not merge the global and .db-scope palettes.
  • Do not add a broad icon library, theme gradient, or shadow language unless the target repo already requires it.
  • Do not replace a repo's existing production design system without first mapping the Bogdan tokens onto its local conventions.

Worked examples

Example 1: Personal finance HTML

User: "Brand this budget pacing page."

Do:

  • Use assets/design-system/colors_and_type.css and self-host the fonts/ directory next to the artifact if it must open from disk.
  • Keep the global page in the Puddles paper/sky system.
  • Put any dense table or operating-model exhibit inside .db-scope.
  • Run the repo's brand_lint.py when present, then inspect mobile and desktop widths for overflow.

Do not:

  • Copy inlined CSS from a prior artifact.
  • Invent new chip colors or use rust as a call-to-action fill.

Example 2: Client-facing artifact

User: "Make this client dashboard look polished."

Do not apply this skill directly. Client context wins. Use the client design system (e.g. an installed *-design skill) unless the user explicitly asks for Dan's personal brand.

Example 3: Plain document or one-pager

User: "Make this internal one-pager feel like my brand."

Do:

  • Preserve the factual content and leave missing owner-authored copy as TBU.
  • Use Instrument Serif for the main title, Geist for body/UI text, and JetBrains Mono for labels or provenance lines.
  • Keep depth flat: borders, rules, spacing, no global shadows or gradients.

Example 4: Financial model exhibit embedded in a broader page

User: "The model table needs to look like finance, but the page should still be mine."

Do:

  • Use the global brand for the page shell.
  • Use .db-scope only around the model exhibit.
  • Format numbers with en-dash zeros, parenthesized negatives, and provenance colors from number-formats.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.