New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Refresh

by rashidrazak in rashidrazak/opencode-cmd-provider

Refresh the bundled catalogs of opencode-cmd-provider — model snapshot, capability facts, and deals catalog — including re-capturing the docs fixtures and running the coverage gate.

MITAuto-check passed

Install Refresh

skills CLI
$ npx skills add rashidrazak/opencode-cmd-provider --skill refresh -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rashidrazak/opencode-cmd-provider refresh --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rashidrazak/opencode-cmd-provider.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/refresh .claude/skills/refresh && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
refresh
GitHub stars
113
Token cost
~1.5k tokens
SKILL.md length
569 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Refresh the bundled catalogs of opencode-cmd-provider — model snapshot, capability facts, and deals catalog — including re-capturing the docs fixtures and running the coverage gate.

  • Works in 6 steps: Refresh the model catalog (snapshot +… → Refresh the deals catalog (offline, from… → Re-capture the fixtures when the gate… → …
  • The user says refresh
  • SKILL.md covers What gets refreshed, Quick start, Workflows and Failure recovery, plus 1 more section
  • Calls npm, npx and node; reaches commandcode.ai

What it does

Refresh is an agent skill from rashidrazak/opencode-cmd-provider. Refresh the bundled catalogs of opencode-cmd-provider — model snapshot, capability facts, and deals catalog — including re-capturing the docs fixtures and running the coverage gate. Use when the user says "refresh", "refresh the catalogs", "update the models", "re-sync the snapshot", "re-capture fixtures", or asks to update model list/pricing/deals data. Not for cutting a release (use the release skill) or for editing the refresh scripts themselves (plain code work).

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with npm. The repository describes itself as: OpenCode plugin for using CommandCode as provider. The licence is MIT.

When your agent uses it

  • The user says refresh
  • Refresh the catalogs
  • Update the models
  • Re-sync the snapshot

Example prompts

  • “refresh”
  • “refresh the catalogs”
  • “update the models”
  • “/refresh”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Refresh the model catalog (snapshot + facts, live)
  2. Refresh the deals catalog (offline, from fixtures)
  3. Re-capture the fixtures when the gate (or a review) shows the docs have
  4. Verify — node scripts/check-deals-coverage.mjs (OK line), then
  5. Review the diff — git diff should show additive entries: new snapshot
  6. Commit — conventional style, e.g. `chore(catalog): refresh to

What it can do on your machine

Read from SKILL.md and the folder at commit c95b2bd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • npx
    • node
    • curl
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • commandcode.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Refresh loads about 1.5k tokens when it runs. Until then it costs about 120 tokens; SKILL.md has 569 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~120
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rashidrazak/opencode-cmd-provider at commit c95b2bd, republished under its MIT licence (© rashidrazak). 569 words, ~1,504 tokens.

Download SKILL.mdSave it as .claude/skills/refresh/SKILL.md (or your agent's skills folder).
name
refresh
description
Refresh the bundled catalogs of opencode-cmd-provider — model snapshot, capability facts, and deals catalog — including re-capturing the docs fixtures and running the coverage gate. Use when the user says "refresh", "refresh the catalogs", "update the models", "re-sync the snapshot", "re-capture fixtures", or asks to update model list/pricing/deals data. Not for cutting a release (use the release skill) or for editing the refresh scripts themselves (plain code work).

Refresh

A Catalog refresh (the model snapshot) plus a Deals catalog refresh updates the generated catalogs so the plugin's bundled data matches Command Code's live catalog (see CONTEXT.md). It happens on demand (typically before a release), never at runtime; the pipeline also refreshes at release time — this skill is the manual, local, commit-ready version of the same work.

What gets refreshed

FileSourceScript
src/catalog/snapshot.tsnpm command-code package models.md (membership authority) + enrichment laddersscripts/refresh-snapshot.mjs
src/catalog/facts.tsnpm command-code bundle (efforts, rates, modalities)scripts/refresh-snapshot.mjs
src/rates-usage/catalog.tsdocs pages / tests/fixtures/*.htmlscripts/refresh-deals.mjs
tests/fixtures/goat.html, pro.htmllive docs capture (deals source)manual fetch

src/catalog/*.ts, src/rates-usage/catalog.ts — generated, never hand-edit (AGENTS.md).

Quick start

bash
npm run refresh            # snapshot + facts (live) + deals (offline fixtures)
node scripts/check-deals-coverage.mjs   # gate: every snapshot model has a deal
npm test                   # full suite (unit + integration + contract + format)

Workflows

  1. Refresh the model catalog (snapshot + facts, live): npm run refresh:snapshot — hits the API + npm registry. Fails hard on network/parse problems.
  2. Refresh the deals catalog (offline, from fixtures): npm run refresh:deals -- --fixtures. If the snapshot gained models the fixtures lack, this aborts with exit 1 naming them — that is the coverage gate doing its job.
  3. Re-capture the fixtures when the gate (or a review) shows the docs have new models (Workflow B), then re-run step 2.
  4. Verify — node scripts/check-deals-coverage.mjs (OK line), then npm test. npm run build needs bun on PATH only when rebuilding the TUI.
  5. Review the diff — git diff should show additive entries: new snapshot ids, new MODEL_DEALS entries, small fixture deltas. Date stamps (FACTS_LAST_REFRESHED, DEAL_LAST_REFRESHED) change by design.
  6. Commit — conventional style, e.g. chore(catalog): refresh to command-code@X.Y.Z.
B. Re-capturing the deals fixtures

The fixtures must stay in sync with the snapshot: a model in the snapshot but missing from the docs pages silently loses its "Command Code" sidebar section (issue: Ox Alpha / DeepSeek V4 Flash Vision (exp) showed no section because the fixtures predated them).

  1. Fetch the two record-bearing pages (the pricing-limits page carries no embedded records — goat and pro are the sources):
    bash
    curl -sL -H 'accept: text/html' https://commandcode.ai/docs/plans/goat -o tests/fixtures/goat.html
curl -sL -H 'accept: text/html' https://commandcode.ai/docs/plans/pro  -o tests/fixtures/pro.html
  2. Regenerate and gate: npm run refresh:deals -- --fixtures — must write 58+ entries, not abort.
  3. git diff --stat tests/fixtures/ — expect a small, noisy delta (the Next.js flight payload embeds a build hash on every capture; the record changes are what matter). Spot-check that only intended models/rates changed.
  4. Run the deals tests: npx tsx tests/parse-docs.test.ts && npx tsx tests/refresh-deals.test.ts && npx tsx tests/deals-coverage.test.ts.
Show full SKILL.md (198 more words)Show less
C. Deals data stale but gate passed

The gate only proves coverage. If deal values (allowances, discounts, benchmarks) are stale, re-capture the fixtures (B), re-run refresh:deals -- --fixtures, and eyeball the diff for rate changes.

Failure recovery

  • refresh:deals aborts with "N snapshot model(s) have no deals record" — fixtures (or live scrape) are behind the snapshot. Re-capture fixtures (B), re-run. Do not pass --allow-partial to ship a partial catalog; that flag is reserved for the release pipeline's non-blocking check.
  • refresh:snapshot fails ("could not parse ... cli.mjs", or an unshippable-row failure after the full ladders) — the CLI bundle shape changed (scripts/parse-modalities.mjs needs updating), or a package row has no context/cost after every enrichment step. A CLI outage (network / 5xx) is not a failure: it degrades to a modalities-pending note with text-only fallbacks. Resolve on main, re-refresh.
  • Network down / docs changed shape — offline still works: npm run refresh:deals -- --fixtures from the committed fixtures; only the fixture re-capture (B) needs the live docs.
  • A stale catalog fails the release run — nothing shipped. Refresh locally, commit, land on main, re-tag (see the release skill).

Reference

  • CONTEXT.md (vocabulary), ADR-0002/0003 (release gates), ADR-0004 (Rates & usage slice), AGENTS.md ("Generated files — do not hand-edit").
  • Mechanics: scripts/refresh-deals.mjs, scripts/refresh-snapshot.mjs, scripts/check-deals-coverage.mjs, tests/deals-coverage.test.ts.

© rashidrazak, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .opencode/skills/refresh of rashidrazak/opencode-cmd-provider.

Open the folder on GitHubat commit c95b2bd

Compare with similar skills

Refresh next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Refresh compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Refresh this skillrashidrazak/opencode-cmd-provider113—~1.5kAutomated safety check: PassMIT
Defuddlekepano/obsidian-skills49k11 repos~208Automated safety check: PassMIT
Vercel Deploybytedance/deer-flow84k10 repos~797Automated safety check: PassMIT
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
Nx Run Tasksnomcopter/react-mosaic4.8k8 repos~613Automated safety check: PassCustom licence

Similar skills

  • Defuddle

    kepano/obsidian-skills

    Uses the Defuddle CLI to pull clean, readable Markdown, JSON or metadata from web pages, stripping navigation, ads and clutter to save tokens.

    49k GitHub starsUsed in 11 repos~208 tokens
    Knowledge ManagementAuto-check passed

  • Vercel Deploy

    bytedance/deer-flow

    Deploys a project to Vercel with one script and no login, then returns a live preview URL and a claim link for moving the deployment into your own Vercel account.

    84k GitHub starsUsed in 10 repos~797 tokens
    DevOps & CloudAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed

  • Nx Run Tasks

    nomcopter/react-mosaic

    Helps with running tasks in an Nx workspace. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 8 repos~613 tokens
    DevelopmentAuto-check passed

  • OpenHarness End-to-End Evals

    HKUDS/OpenHarness

    Validates OpenHarness features by running real multi-turn agent loops with live LLM calls against an unfamiliar codebase, checking actual tool execution.

    16k GitHub starsUsed in 1 repo~2.1k tokens
    Testing & QAAuto-check: notes

More from rashidrazak/opencode-cmd-provider

  • Release

    rashidrazak/opencode-cmd-provider

    Cut a release of opencode-cmd-provider — bump the version, write the CHANGELOG entry, refresh the catalog snapshot, tag, and verify the pipeline's publish.

    113 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Refresh

What does Refresh do?

Refresh the bundled catalogs of opencode-cmd-provider — model snapshot, capability facts, and deals catalog — including re-capturing the docs fixtures and running the coverage gate. Refresh is an agent skill from rashidrazak/opencode-cmd-provider. Refresh the bundled catalogs of opencode-cmd-provider — model snapshot, capability facts, and deals catalog — including re-capturing the docs fixtures and running the coverage gate.

When should I use Refresh?

Refresh fits situations like: the user says refresh; refresh the catalogs; update the models; re-sync the snapshot.

How do I install Refresh in Claude Code?

Run `npx skills add rashidrazak/opencode-cmd-provider --skill refresh -a claude-code`. Or copy the skill folder (.opencode/skills/refresh in rashidrazak/opencode-cmd-provider) into .claude/skills/refresh in your project. Claude Code loads it when a task matches its description.

How do I install Refresh in Codex?

Run `npx skills add rashidrazak/opencode-cmd-provider --skill refresh -a codex`. Or copy the skill folder (.opencode/skills/refresh in rashidrazak/opencode-cmd-provider) into .agents/skills/refresh in your project. Codex loads it when a task matches its description.

Can I use Refresh in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rashidrazak/opencode-cmd-provider --skill refresh -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/refresh, .gemini/skills/refresh, .github/skills/refresh and .opencode/skills/refresh in your project.

What does Refresh need to run?

Going by SKILL.md and its folder, Refresh needs the command-line tools its instructions call (npm, npx, node, curl and git). Our summary lists: Node.js.

Does Refresh access the network?

SKILL.md names 1 domain. In commands or code: commandcode.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Refresh safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Refresh use?

Refresh is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Refresh use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Refresh?

Skills that share tags, products or a category with Refresh: Defuddle (kepano/obsidian-skills, 49k stars), Vercel Deploy (bytedance/deer-flow, 84k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars) and Knap Markdown Templates (kepano/obsidian-skills, 49k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Refresh?

rashidrazak (a GitHub user) maintains it in rashidrazak/opencode-cmd-provider, which has 113 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 8, 2026.

Source: rashidrazak/opencode-cmd-provider on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.