Skip to content

aiskillstore/marketplace / skills/aayushbaniya2006/credits-handler

credits-handler

Verified

Manage the credit system (allocation, purchasing, usage). Use when adding credit types, configuring pricing, or building credit UI.

FileKindSize
SKILL.mdskill md5.4 KB
reference.mdmarkdown802 B
skill-report.jsonconfig33.2 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-06T00:38:29.731Z",
    "slug": "aayushbaniya2006-credits-handler",
    "source_url": "https://github.com/AayushBaniya2006/blinkfund/tree/main/.claude/skills/credits-handler",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "d285f2e4629541b7d1cd52ad79d5dc81360c544ec949ea71666a7d393f73f17d",
    "tree_hash": "69b100eb6b38190ffec8fd48389318bbc2aba0f24c56e1978a3f0030640151b5",
    "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": "credits-handler",
    "description": "Manage the credit system (allocation, purchasing, usage). Use when adding credit types, configuring pricing, or building credit UI.",
    "summary": "Guides TypeScript credit system changes for credit types, pricing, purchase UI, balance display, and backend operations.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "AayushBaniya2006",
    "license": "MIT",
    "tags": [
      "credits",
      "billing",
      "payments",
      "typescript",
      "react"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All static findings are false positives caused by Markdown inline code, code fences, and TypeScript or TSX examples. The scanned files show documentation for credit-system integration, with no shell execution, prompt injection, or data exfiltration intent.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 12,
            "line_end": 12
          },
          {
            "file": "SKILL.md",
            "line_start": 15,
            "line_end": 15
          },
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 22
          },
          {
            "file": "SKILL.md",
            "line_start": 22,
            "line_end": 24
          },
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 41
          },
          {
            "file": "SKILL.md",
            "line_start": 41,
            "line_end": 43
          },
          {
            "file": "SKILL.md",
            "line_start": 43,
            "line_end": 47
          },
          {
            "file": "SKILL.md",
            "line_start": 47,
            "line_end": 49
          },
          {
            "file": "SKILL.md",
            "line_start": 49,
            "line_end": 50
          },
          {
            "file": "SKILL.md",
            "line_start": 50,
            "line_end": 53
          },
          {
            "file": "SKILL.md",
            "line_start": 53,
            "line_end": 63
          },
          {
            "file": "SKILL.md",
            "line_start": 63,
            "line_end": 66
          },
          {
            "file": "SKILL.md",
            "line_start": 66,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 106
          },
          {
            "file": "SKILL.md",
            "line_start": 106,
            "line_end": 122
          },
          {
            "file": "SKILL.md",
            "line_start": 122,
            "line_end": 126
          },
          {
            "file": "SKILL.md",
            "line_start": 126,
            "line_end": 128
          },
          {
            "file": "SKILL.md",
            "line_start": 128,
            "line_end": 129
          },
          {
            "file": "SKILL.md",
            "line_start": 129,
            "line_end": 132
          },
          {
            "file": "SKILL.md",
            "line_start": 132,
            "line_end": 140
          },
          {
            "file": "SKILL.md",
            "line_start": 140,
            "line_end": 143
          },
          {
            "file": "SKILL.md",
            "line_start": 143,
            "line_end": 157
          },
          {
            "file": "SKILL.md",
            "line_start": 157,
            "line_end": 164
          },
          {
            "file": "SKILL.md",
            "line_start": 164,
            "line_end": 165
          },
          {
            "file": "SKILL.md",
            "line_start": 165,
            "line_end": 166
          },
          {
            "file": "SKILL.md",
            "line_start": 166,
            "line_end": 166
          },
          {
            "file": "SKILL.md",
            "line_start": 167,
            "line_end": 170
          },
          {
            "file": "SKILL.md",
            "line_start": 170,
            "line_end": 170
          },
          {
            "file": "SKILL.md",
            "line_start": 171,
            "line_end": 175
          },
          {
            "file": "SKILL.md",
            "line_start": 175,
            "line_end": 177
          },
          {
            "file": "SKILL.md",
            "line_start": 177,
            "line_end": 190
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "blocker:reference.md:19:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "reference.md",
        "line_start": 19,
        "line_end": 19,
        "snippet": "1. **Stable Core**: Rely on exported functions (`addCredits`, `useCredits`). Avoid changing `recalcu"
      },
      {
        "id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 12,
        "line_end": 12,
        "snippet": "All credit configuration lives in `src/lib/credits/config.ts`."
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 15,
        "line_end": 15,
        "snippet": "1.  **Define the Type**: Add the new type to `creditTypeSchema` enum."
      },
      {
        "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": 22,
        "snippet": "```typescript"
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 22,
        "line_end": 24,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 25,
        "snippet": "2.  **Configure Pricing & Metadata**: Add an entry to `creditsConfig`."
      },
      {
        "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": 41,
        "snippet": "```typescript"
      },
      {
        "id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 41,
        "line_end": 43,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 43,
        "line_end": 47,
        "snippet": "3.  **Plan Allocations (Optional)**: Define how many credits are given when subscribing to a plan in"
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 47,
        "line_end": 49,
        "snippet": "To let users purchase credits, use the `useBuyCredits` hook. This hook handles price calculation (fa"
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 49,
        "line_end": 50,
        "snippet": "### Key Hook: `useBuyCredits`"
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 50,
        "line_end": 53,
        "snippet": "**Location**: `src/lib/credits/useBuyCredits.ts`"
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 53,
        "line_end": 63,
        "snippet": "```typescript"
      },
      {
        "id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 63,
        "line_end": 66,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 66,
        "line_end": 68,
        "snippet": "Here is a pattern for creating a credit purchase UI, similar to `src/components/website/website-cred"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 106,
        "snippet": "```tsx"
      },
      {
        "id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 106,
        "line_end": 122,
        "snippet": "`$${price?.toFixed(2) || \"0.00\"}`"
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 122,
        "line_end": 126,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 126,
        "line_end": 128,
        "snippet": "To show the user's current balance, use the `useCredits` hook."
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 128,
        "line_end": 129,
        "snippet": "### Key Hook: `useCredits`"
      },
      {
        "id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 129,
        "line_end": 132,
        "snippet": "**Location**: `src/lib/users/useCredits.ts`"
      },
      {
        "id": "external_commands:SKILL.md:132:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 132,
        "line_end": 140,
        "snippet": "```typescript"
      },
      {
        "id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 140,
        "line_end": 143,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 143,
        "line_end": 157,
        "snippet": "```tsx"
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 164,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:164:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 164,
        "line_end": 165,
        "snippet": "Use `allocatePlanCredits` to give users credits when they subscribe/upgrade."
      },
      {
        "id": "external_commands:SKILL.md:165:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 165,
        "line_end": 166,
        "snippet": "- **File**: `src/lib/credits/allocatePlanCredits.ts`"
      },
      {
        "id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 166,
        "line_end": 166,
        "snippet": "- **Input**: `userId`, `planId`, `paymentId` (for idempotency)."
      },
      {
        "id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 167,
        "line_end": 170,
        "snippet": "- **Behavior**: Checks `onPlanChangeCredits` config and adds credits if applicable."
      },
      {
        "id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 170,
        "line_end": 170,
        "snippet": "To manually manipulate balances, use helpers from `src/lib/credits/recalculate.ts` (e.g., `addCredit"
      },
      {
        "id": "external_commands:SKILL.md:171:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 171,
        "line_end": 175,
        "snippet": "*Note: Always ensure you have a unique `paymentId` or transaction reference when adding credits to p"
      },
      {
        "id": "external_commands:SKILL.md:175:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 175,
        "line_end": 177,
        "snippet": "Use `canDeductCredits` before performing an action."
      },
      {
        "id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 177,
        "line_end": 190,
        "snippet": "```typescript"
      }
    ],
    "finding_verdicts": [
      {
        "id": "blocker:reference.md:19:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "reference.md line 19 recommends using stable exported credit helpers and avoiding direct edits. It does not collect host, user, process, or system information."
      },
      {
        "id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 12 uses Markdown inline code for a TypeScript file path. There is no Ruby, shell, or command execution instruction."
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 15 uses Markdown inline code for a schema name. It is documentation text, not an executable command."
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md lines 16-22 contain a fenced TypeScript enum example. The backticks delimit documentation and do not invoke a shell."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 22 is a closing Markdown code fence. It is not a Ruby backtick expression or shell execution."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 24 uses Markdown inline code for a configuration object name. There is no executable command."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md lines 25-41 contain a fenced TypeScript configuration example. The content is static documentation, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 41 is a closing Markdown code fence. It does not execute Ruby or shell code."
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 43 uses Markdown inline code for an application configuration field. It is not a command execution pattern."
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 47 names an application hook in Markdown inline code. It describes checkout URL generation through project code, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 49 formats a hook name with Markdown inline code. It is documentation text only."
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 50 formats a TypeScript file path with Markdown inline code. It contains no command invocation."
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md lines 53-63 contain a fenced TypeScript usage example. The fence is Markdown syntax and is not executable by the skill."
      },
      {
        "id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 63 is a closing Markdown code fence. It is not a shell or Ruby execution construct."
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 66 formats a TSX file path with Markdown inline code. It is a reference to project documentation, not a command."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md lines 68-122 contain a fenced TSX UI example. The backticks are Markdown delimiters, and the example does not run shell commands."
      },
      {
        "id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 106 is a JavaScript template literal used to render a price string in TSX. It does not execute a shell command."
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 122 is a closing Markdown code fence. It has no command execution behavior."
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 126 formats an application hook name with Markdown inline code. It is safe documentation text."
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 128 formats a hook name with Markdown inline code. It is not executable code."
      },
      {
        "id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 129 formats a TypeScript file path with Markdown inline code. It contains no shell command."
      },
      {
        "id": "external_commands:SKILL.md:132:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md lines 132-140 contain a fenced TypeScript return shape example. The code fence is documentation markup, not execution."
      },
      {
        "id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 140 is a closing Markdown code fence. It is not a command execution construct."
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md lines 143-157 contain a fenced TSX balance display example. It is documentation and does not invoke external commands."
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 157 is a closing Markdown code fence. It has no executable behavior."
      },
      {
        "id": "external_commands:SKILL.md:164:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 164 formats an application helper name with Markdown inline code. It is a function reference, not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:165:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 165 formats a TypeScript file path with Markdown inline code. It does not invoke a command interpreter."
      },
      {
        "id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 166 formats parameter names with Markdown inline code. It is explanatory text only."
      },
      {
        "id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 167 formats a configuration name with Markdown inline code. It does not execute code."
      },
      {
        "id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 170 formats file and helper names with Markdown inline code. It documents credit helpers and has no shell command."
      },
      {
        "id": "external_commands:SKILL.md:171:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 171 formats a payment identifier name with Markdown inline code. It is a safety note, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:175:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md line 175 formats a balance-check helper name with Markdown inline code. It is a function reference, not a command."
      },
      {
        "id": "external_commands:SKILL.md:177:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "SKILL.md lines 177-190 contain a fenced TypeScript balance-check example. The code fence is Markdown documentation, not shell execution."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 2,
    "total_lines": 217,
    "audit_model": "codex",
    "audited_at": "2026-07-06T00:38:29.731Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Build Credit Purchase and Balance Flows",
    "value_statement": "Credit features can fail when pricing, balances, and UI flows become inconsistent. This skill guides credit types, purchase flows, balance displays, and allocation helpers.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "credit system",
      "billing workflow",
      "payment integration",
      "TypeScript credits",
      "React credit UI",
      "credit balance management",
      "checkout flow"
    ],
    "actual_capabilities": [
      "Shows where to add credit types in the shared credit configuration.",
      "Explains pricing slabs, currencies, minimum amounts, and plan allocations.",
      "Demonstrates the useBuyCredits hook for price calculation and checkout URL creation.",
      "Provides TSX patterns for credit purchase cards and balance displays.",
      "Identifies backend helpers for allocating, adding, deducting, and checking credits."
    ],
    "limitations": [
      "It documents existing project paths and does not implement missing application code.",
      "It assumes the referenced credit, plan, and user hooks already exist.",
      "It does not verify payment provider configuration or webhook authenticity.",
      "It does not replace authorization, audit logging, or financial reconciliation controls."
    ],
    "use_cases": [
      {
        "title": "Add a Paid Credit Type",
        "target_user": "Product engineer",
        "description": "Define a new credit type with pricing metadata and optional plan allocation rules."
      },
      {
        "title": "Create Credit Purchase UI",
        "target_user": "Frontend developer",
        "description": "Build a purchase card that displays calculated prices and starts the checkout flow."
      },
      {
        "title": "Wire Backend Credit Checks",
        "target_user": "Backend engineer",
        "description": "Use shared helpers to allocate credits, prevent duplicate additions, and check balances before paid actions."
      }
    ],
    "prompt_templates": [
      {
        "title": "Locate Credit Settings",
        "scenario": "Beginner setup",
        "prompt": "Use the credits-handler skill to explain where credit types, pricing, and plan allocation settings live in this project."
      },
      {
        "title": "Add a Credit Type",
        "scenario": "Configuration change",
        "prompt": "Use the credits-handler skill to guide adding a new credit type for [feature] with pricing slabs and a minimum purchase amount."
      },
      {
        "title": "Build Purchase UI",
        "scenario": "Frontend implementation",
        "prompt": "Use the credits-handler skill to design a credit purchase card for [credit type] that calculates price and starts checkout."
      },
      {
        "title": "Review Credit Flow",
        "scenario": "Advanced integration review",
        "prompt": "Use the credits-handler skill to review my credit purchase, allocation, balance display, and deduction flow for missing integration steps."
      }
    ],
    "output_examples": [
      {
        "input": "I need to add credits for video generation.",
        "output": [
          "Add the video credit type to the shared credit type list.",
          "Create pricing metadata with currency, minimum amount, and slabs.",
          "Add optional plan allocation rules if subscriptions should include credits.",
          "Update purchase and balance UI to display the new credit type."
        ]
      },
      {
        "input": "I need a page where users buy image credits.",
        "output": "The skill would point to the project purchase hook, explain package sizing, show price loading states, and route users into checkout."
      },
      {
        "input": "I want to deduct credits before a premium action.",
        "output": [
          "Check the user balance before starting the paid action.",
          "Stop the action when the balance is too low.",
          "Use shared backend helpers for any balance change."
        ]
      }
    ],
    "best_practices": [
      "Keep credit types, pricing, and allocation settings in the shared configuration.",
      "Use idempotent payment or transaction identifiers when adding credits.",
      "Check balances before paid actions and refresh displayed balances after changes."
    ],
    "anti_patterns": [
      "Do not edit cached user balances directly.",
      "Do not create purchase buttons that bypass the shared price calculation hook.",
      "Do not add credits without a unique payment or transaction reference."
    ],
    "faq": [
      {
        "question": "Can this skill create a full billing system?",
        "answer": "No. It guides changes to an existing credit system and referenced project helpers."
      },
      {
        "question": "Can it help add a new credit type?",
        "answer": "Yes. It explains where to update type definitions, pricing metadata, and optional plan allocations."
      },
      {
        "question": "Can it build a purchase interface?",
        "answer": "Yes. It provides a pattern for purchase cards that show calculated prices and start checkout."
      },
      {
        "question": "Does it show user balances?",
        "answer": "Yes. It describes the existing balance hook and a simple balance display pattern."
      },
      {
        "question": "Does it handle authorization?",
        "answer": "No. Authorization, payment verification, and audit logging remain application responsibilities."
      },
      {
        "question": "Can I use it with Codex and Claude Code?",
        "answer": "Yes. The skill declares support for Claude, Codex, and Claude Code."
      }
    ]
  },
  "file_structure": [
    {
      "name": "reference.md",
      "type": "file",
      "path": "reference.md",
      "lines": 23
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 194
    }
  ]
}
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