skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
bluzir/claude-code-design49 installs

ingest-github

Clone a GitHub repo and extract design tokens (colors, fonts, spacing) from its codebase. Use when user gives a github.com URL and wants a design system or design work rooted in the repo's style.

How do I install this agent skill?

npx skills add https://github.com/bluzir/claude-code-design --skill ingest-github
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubwarn

    The skill is functional for extracting design tokens but presents a potential command injection risk due to dynamic input in shell commands. It is also susceptible to indirect prompt injection from malicious files within a cloned repository.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Ingest GitHub

Pull a repo into a temp location and extract design tokens. No manual git clone required for the user — uses gh CLI.

Preflight

  1. Bash(which gh) — if missing, tell user: brew install gh && gh auth login
  2. Check $ARGUMENTS matches github.com/owner/repo[/(tree|blob)/ref/path]

Steps

  1. Parse URL into {owner, repo, ref, subpath}.

    • Bare repo: github.com/foo/bar → {owner:foo, repo:bar, ref:default, subpath:''}
    • Tree: github.com/foo/bar/tree/main/src → {owner:foo, repo:bar, ref:main, subpath:'src'}
  2. Clone shallow into a temp dir under /tmp/cd-ingest-<slug>-<timestamp>:

    Bash(mkdir -p /tmp/cd-ingest-<slug>)
    Bash(gh repo clone <owner>/<repo> /tmp/cd-ingest-<slug>/<repo> -- --depth 1 --branch <ref>)
    
  3. Find token files via Glob (in clone path):

    • **/theme.{ts,tsx,js,jsx,json}
    • **/tokens.{css,scss,json}
    • **/tailwind.config.{js,ts,cjs,mjs}
    • **/_variables.{css,scss}
    • **/colors.{ts,js,json}
    • **/*.tokens.json (W3C DTCG format)
    • **/design-tokens.*
    • **/palette.*
  4. Read candidate files (cap at 20 biggest) and extract:

    • Colors: regex #[0-9a-fA-F]{3,8}, rgb\(...\), oklch\(...\), hsl\(...\) + the var/key they're assigned to
    • Fonts: font-family: values, named font stacks
    • Spacing: numeric scales in Tailwind config, CSS vars with --space-* / --spacing-* / --gap-*
    • Radii: CSS vars with --radius-* / --rounded-*, Tailwind borderRadius config
  5. Write structured output:

    artifacts/ingested/<repo>-tokens.json
    

    Schema:

    {
      "source": { "url": "...", "ref": "...", "ingested_at": "2026-04-20T..." },
      "colors": { "primary": "#...", "accent": "#...", "bg": "#...", "text": "#...", "semantic": {...}, "all": {...} },
      "fonts": { "display": "...", "body": "...", "mono": "...", "stacks": [...] },
      "spacing": [...],
      "radii": { "sm": 4, "md": 8, "lg": 16 },
      "shadows": [...],
      "components": { "Button": { "found_at": "src/.../Button.tsx" }, ... }
    }
    
  6. Summarize to user:

    • "Found N colors, M fonts, spacing scale [...], K radii. Saved to artifacts/ingested/<repo>-tokens.json."
    • Offer: /create-design-system to turn into visual style guide, or start /make-deck / /interactive-prototype with these tokens pre-loaded.
  7. Cleanup: optionally Bash(rm -rf /tmp/cd-ingest-<slug>) — or keep for further exploration.

Failure modes

  • No gh → clear error + install instruction
  • Repo private + no auth → gh auth login prompt
  • No tokens found → report "repo has no clear design tokens; suggest manual AskUserQuestion fallback or try a specific subpath"
  • Huge repo (>500MB) → warn user, offer --subpath to narrow

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/bluzir/claude-code-design/ingest-github">View ingest-github on skillZs</a>