Skip to content

aiskillstore/marketplace / skills/aayushbaniya2006/theme-handler

theme-handler

Verified

Manage and update application themes using shadcn and tweakcn.

FileKindSize
SKILL.mdskill md844 B
reference.mdmarkdown2.5 KB
skill-report.jsonconfig16.1 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-05T00:07:38.589Z",
    "slug": "aayushbaniya2006-theme-handler",
    "source_url": "https://github.com/AayushBaniya2006/blinkfund/tree/main/.claude/skills/theme-handler",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "4415124cbf9410adc0403fc75b0ec2d6f1d4ac325eac8750393df465de7210c5",
    "tree_hash": "de976ff58ea315fbe0515c9115543dd04d6987cf97678349635f39270e10797f",
    "provenance": {
      "model_requested": "gpt-5.5:high",
      "model_effective": "codex:gpt-5.5:high",
      "fallback_chain": [
        {
          "agent": "codex",
          "model": "gpt-5.5",
          "effort": "high",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "theme-handler",
    "description": "Manage shadcn application themes with tweakcn reference URLs and installation guidance.",
    "summary": "Helps apply tweakcn themes to shadcn UI projects.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "AayushBaniya2006",
    "license": "MIT",
    "tags": [
      "shadcn",
      "tweakcn",
      "themes",
      "ui-design",
      "design-system"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network"
    ],
    "category": "design"
  },
  "security_audit": {
    "risk_level": "medium",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "The skill has a legitimate design workflow, but it instructs agents to run pnpm dlx shadcn@latest and import remote tweakcn theme files. I confirmed the real command and network risks, dismissed one markdown fence false positive, and found no prompt injection text.",
    "remediation": [
      {
        "issue": "Mutable package command",
        "suggestion": "Pin the shadcn CLI version or require user approval before any command using shadcn@latest.",
        "severity": "medium"
      },
      {
        "issue": "Theme URL can be substituted",
        "suggestion": "Only allow URLs from reference.md or require explicit confirmation before using another theme URL.",
        "severity": "medium"
      },
      {
        "issue": "Remote theme content is imported",
        "suggestion": "Tell users to review generated changes before committing theme updates.",
        "severity": "low"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          },
          {
            "file": "SKILL.md",
            "line_start": 17,
            "line_end": 19
          },
          {
            "file": "SKILL.md",
            "line_start": 19,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 27
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "2.  **Install Command**: Run the following command, replacing `<theme-url>` with your choice:"
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 17,
        "line_end": 19,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 19,
        "line_end": 25,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 25,
        "line_end": 27,
        "snippet": "```bash"
      },
      {
        "id": "network:SKILL.md:26:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "pnpm dlx shadcn@latest add https://tweakcn.com/r/themes/modern-minimal.json"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.78,
        "reason": "Line 16 directs the agent to run an install command with a replaceable theme URL. This is real external command behavior with remote input, even though the match is markdown prose.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.9,
        "reason": "The fenced command uses pnpm dlx shadcn@latest with a theme URL placeholder. It executes a mutable package command and can fetch third-party theme content.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "The matched range is markdown fence text and an example heading, not executable backtick syntax. The actual command risk is covered by the nearby command findings."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.91,
        "reason": "The example command runs pnpm dlx shadcn@latest add with a hardcoded remote tweakcn URL. That is an external package command with network-sourced input.",
        "severity": "medium"
      },
      {
        "id": "network:SKILL.md:26:hardcoded-url",
        "verdict": "confirmed",
        "confidence": 0.84,
        "reason": "The command fetches a remote theme JSON file from tweakcn.com. The domain matches the skill purpose, but it remains an external network dependency.",
        "severity": "low"
      }
    ],
    "semantic_findings": [
      {
        "title": "Unpinned Package Manager Execution",
        "description": "The skill instructs use of shadcn@latest through pnpm dlx, so the executed CLI can change over time without review.",
        "severity": "medium",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          }
        ],
        "confidence": 0.88,
        "confidence_reasoning": "Both command examples explicitly use shadcn@latest. Mutable package execution is a supply-chain risk even when the command is legitimate."
      }
    ],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "2.  **Install Command**: Run the following command, replacing `<theme-url>` with your choice:",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 16
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.78,
        "confidence_reasoning": "Line 16 directs the agent to run an install command with a replaceable theme URL. This is real external command behavior with remote input, even though the match is markdown prose."
      },
      {
        "title": "Ruby/shell backtick execution",
        "description": "```bash",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 17,
            "line_end": 19
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.9,
        "confidence_reasoning": "The fenced command uses pnpm dlx shadcn@latest with a theme URL placeholder. It executes a mutable package command and can fetch third-party theme content."
      },
      {
        "title": "Ruby/shell backtick execution",
        "description": "```bash",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 27
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.91,
        "confidence_reasoning": "The example command runs pnpm dlx shadcn@latest add with a hardcoded remote tweakcn URL. That is an external package command with network-sourced input."
      },
      {
        "title": "Unpinned Package Manager Execution",
        "description": "The skill instructs use of shadcn@latest through pnpm dlx, so the executed CLI can change over time without review.",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          }
        ],
        "review_kind": "security",
        "source_category": "semantic",
        "source_severity": "medium",
        "confidence": 0.88,
        "confidence_reasoning": "Both command examples explicitly use shadcn@latest. Mutable package execution is a supply-chain risk even when the command is legitimate."
      }
    ],
    "low_findings": [
      {
        "title": "Hardcoded URL",
        "description": "pnpm dlx shadcn@latest add https://tweakcn.com/r/themes/modern-minimal.json",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          }
        ],
        "review_kind": "capability",
        "source_category": "network",
        "source_severity": "low",
        "confidence": 0.84,
        "confidence_reasoning": "The command fetches a remote theme JSON file from tweakcn.com. The domain matches the skill purpose, but it remains an external network dependency."
      }
    ],
    "dangerous_patterns": [],
    "files_scanned": 2,
    "total_lines": 80,
    "audit_model": "codex",
    "audited_at": "2026-07-05T00:07:38.589Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Apply shadcn Themes from tweakcn",
    "value_statement": "Teams lose time translating theme choices into repeatable shadcn commands. This skill uses tweakcn references to select a theme and guide installation.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "shadcn themes",
      "tweakcn themes",
      "theme handler",
      "UI theme automation",
      "design system themes",
      "Next.js theme setup",
      "pnpm shadcn"
    ],
    "actual_capabilities": [
      "Lists available tweakcn themes from the included reference file.",
      "Maps named themes to installation URLs when listed in reference.md.",
      "Provides the shadcn command format for applying a theme.",
      "Supports direct theme update requests such as Modern Minimal.",
      "Points users to the reference file for all available theme URLs."
    ],
    "limitations": [
      "Requires a project that already supports shadcn theme installation.",
      "Uses pnpm in the documented command examples.",
      "Depends on remote tweakcn URLs being available and trustworthy.",
      "Does not validate or preview theme content before installation."
    ],
    "use_cases": [
      {
        "title": "Apply a Selected Theme",
        "description": "A developer can request a named tweakcn theme and receive the matching install workflow.",
        "target_user": "Frontend developer"
      },
      {
        "title": "Compare Theme Options",
        "description": "A designer can review available theme names before choosing a visual direction.",
        "target_user": "Product designer"
      },
      {
        "title": "Standardize Theme Updates",
        "description": "A maintainer can keep theme changes tied to a documented reference list.",
        "target_user": "Project maintainer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Apply a Named Theme",
        "prompt": "Use theme-handler to update the app theme to Modern Minimal.",
        "scenario": "Beginner request for a listed theme."
      },
      {
        "title": "Show Theme Choices",
        "prompt": "List available tweakcn themes and help me choose a clean SaaS theme.",
        "scenario": "User wants guidance before changing files."
      },
      {
        "title": "Confirm Before Installing",
        "prompt": "Prepare the Graphite theme update and ask me before running the install command.",
        "scenario": "User wants command review before execution."
      },
      {
        "title": "Match Product Direction",
        "prompt": "Review the current visual direction, choose a matching reference theme, and ask before installation.",
        "scenario": "Advanced selection based on product context."
      }
    ],
    "output_examples": [
      {
        "input": "Update the theme to Modern Minimal.",
        "output": "The skill identifies Modern Minimal in the reference list and prepares the matching shadcn theme installation workflow."
      },
      {
        "input": "Show me clean theme options for a dashboard.",
        "output": "The skill suggests relevant listed themes and explains which options fit a restrained dashboard interface."
      },
      {
        "input": "Apply Graphite, but confirm first.",
        "output": "The skill selects Graphite, summarizes the planned change, and waits for approval before running the install step."
      }
    ],
    "best_practices": [
      "Review the selected theme URL before running any install command.",
      "Confirm the project uses shadcn and pnpm before applying a theme.",
      "Commit or back up theme files before installing a new theme."
    ],
    "anti_patterns": [
      "Running a theme URL that is not in the trusted reference list.",
      "Applying a theme without reviewing generated style changes.",
      "Using mutable latest package commands in unattended automation."
    ],
    "faq": [
      {
        "question": "What does this skill do?",
        "answer": "It helps apply tweakcn themes to shadcn UI projects using a documented reference list."
      },
      {
        "question": "Does it need internet access?",
        "answer": "Yes. The documented workflow fetches the shadcn CLI and remote tweakcn theme files."
      },
      {
        "question": "Can I use another package manager?",
        "answer": "The skill documents pnpm commands. You must adapt the command manually for another package manager."
      },
      {
        "question": "Can it choose a theme for me?",
        "answer": "It can use the reference list to suggest themes when you describe the desired style."
      },
      {
        "question": "Does it create a full design system?",
        "answer": "No. It applies theme presets and does not define complete product design rules."
      },
      {
        "question": "Is it safe to run automatically?",
        "answer": "Review the command and theme source first because the workflow runs external package and network operations."
      }
    ]
  },
  "file_structure": [
    {
      "name": "reference.md",
      "type": "file",
      "path": "reference.md",
      "lines": 48
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 32
    }
  ]
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall