Agent skill

Convex Docs

by openclaw in openclaw/clawhub

Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check nodemodules types, freshness hierarchy — instead of writing a…

MITAuto-check passedDocuments & Office

Install Convex Docs

skills CLI
$ npx skills add openclaw/clawhub --skill convex-docs -a claude-code

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

GitHub CLI
$ gh skill install openclaw/clawhub convex-docs --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/openclaw/clawhub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/convex-docs .claude/skills/convex-docs && 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
convex-docs
GitHub stars
9.5k
Token cost
~837 tokens
SKILL.md length
435 words
Files
1
Skills in repo
57
Repo updated
First seen
Licence
MIT

At a glance

Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check nodemodules types, freshness hierarchy — instead of writing a…

  • Works in 5 steps: PIN the version: read the installed… → FRESHNESS HIERARCHY (cheapest-correct… → VERIFY against the installed package… → …
  • Documents & Office work in your project
  • SKILL.md covers Workflow and Rules
  • Calls node

What it does

Convex Docs is an agent skill from openclaw/clawhub. Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check nodemodules types, freshness hierarchy — instead of writing a possibly-stale API from memory.

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

It sits in Documents & Office. It works with Convex and npm. The repository describes itself as: Skill + Plugin Registry for OpenClaw. The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/convex-docs”

Workflow steps

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

  1. PIN the version: read the installed convex version (node -p "require('./node_modules/convex/package.json').version" or package.json), and…
  2. FRESHNESS HIERARCHY (cheapest-correct first, the Supabase-taught order)
  3. VERIFY against the installed package when it matters: for a component export you're unsure exists, check node_modules/@convex-dev// (its…
  4. USE the fetched fact narrowly: apply the current signature/flag, cite where it came from (page + version), and hand the actual code back…
  5. On a version-mismatch build error (an export/flag that 'should' exist but doesn't): treat it as a currentness question — pin the version…

What it can do on your machine

Read from SKILL.md and the folder at commit a18bc74. 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:

    • node

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

  • Network

    No URLs in SKILL.md.

    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

Convex Docs loads about 837 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 435 words of instructions outside code blocks.

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

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 openclaw/clawhub at commit a18bc74, republished under its MIT licence (© openclaw). 435 words, ~837 tokens.

Download SKILL.mdSave it as .claude/skills/convex-docs/SKILL.md (or your agent's skills folder).
name
convex-docs
description
Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check node_modules types, freshness hierarchy — instead of writing a possibly-stale API from memory.
<!-- GENERATED from convex-agents content/capabilities/convex-docs.json — do not edit by hand. -->

Pull version-current Convex docs

convex-expert carries baked, plugin-versioned knowledge — excellent for stable idioms, but it goes stale exactly where it hurts: a component that gained a new export, a CLI flag that changed, an API renamed between versions. This capability is the freshness discipline layered on top: pin to the project's real version, fetch the live page cheaply as markdown, and never write an unfamiliar API from memory when the current source is one fetch away.

Workflow

  1. PIN the version: read the installed convex version (node -p "require('./node_modules/convex/package.json').version" or package.json), and the versions of any @convex-dev/* components in play. The docs you trust must match THESE versions — version skew is the single largest source of wrong Convex code.
  2. FRESHNESS HIERARCHY (cheapest-correct first, the Supabase-taught order): (a) if a served docs tool / MCP search_convex_docs is available, use it (it returns version-scoped, reranked answers sized to the context window); (b) else fetch the specific docs page as MARKDOWN — request docs.convex.dev/<path> and prefer a .md/markdown form when the site serves one (far fewer tokens than HTML), or the component's README at the pinned version; (c) only then fall back to a general web search, and treat its version as unverified. Do NOT skip to writing the API from memory when currentness is in doubt.
  3. VERIFY against the installed package when it matters: for a component export you're unsure exists, check node_modules/@convex-dev/<x>/ (its package.json exports, its .d.ts) — the installed types are the ground truth for THIS version, more authoritative than any doc.
  4. USE the fetched fact narrowly: apply the current signature/flag, cite where it came from (page + version), and hand the actual code back to convex-expert to write idiomatically. convex-docs supplies the fresh fact; convex-expert supplies the idiom.
  5. On a version-mismatch build error (an export/flag that 'should' exist but doesn't): treat it as a currentness question — pin the version, fetch the current API, and correct — rather than guessing a different spelling.
Show full SKILL.md (113 more words)Show less

Rules

  • Never write an unfamiliar or possibly-renamed Convex/component API from model memory when currentness is in doubt — pin the version and fetch the current source first.
  • The installed package's own exports/.d.ts in node_modules is the ground truth for this version — more authoritative than any doc page.
  • Follow the freshness hierarchy: served docs tool → page-as-markdown / pinned README → general web (unverified) — cheapest-correct first, fewest tokens.
  • Prefer markdown over HTML doc pages — far fewer tokens for the same content.
  • Supply the fresh FACT; hand idiomatic code back to convex-expert. This is a freshness layer, not a replacement for the baked knowledge.
  • A version-mismatch build error is a currentness question, not a spelling guess — re-pin and re-fetch.

© openclaw, 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 .agents/skills/convex-docs of openclaw/clawhub.

Open the folder on GitHubat commit a18bc74

Compare with similar skills

Convex Docs 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.

Convex Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Convex Docs this skillopenclaw/clawhub9.5k—~837Automated safety check: PassMIT
Convex Release Auditudecode/kitcn450—~1.8kAutomated safety check: PassApache-2.0
Convex Quickstartspokvulcan/poker-planning1146 repos~3.5kAutomated safety check: NotesMIT
Slidev Migrateleochiu-a/slidev-workspace171—~954Automated safety check: PassMIT
Portaljs Add Datasetdatopian/portaljs2.4k—~1.6kAutomated safety check: PassMIT
Opendocsioteverythin/OpenDocs233—~746Automated safety check: NotesMIT

Similar skills

  • Audit newer Convex npm releases against kitcn. An agent skill from udecode/kitcn.

    450 GitHub stars~1.8k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Convex Quickstart

    spokvulcan/poker-planning

    Creates or adds Convex to an app. An agent skill from spokvulcan/poker-planning.

    114 GitHub starsUsed in 6 repos~3.5k tokens
    Frontend & DesignAuto-check: notes
  • Slidev Migrate

    leochiu-a/slidev-workspace

    Migrate a single Slidev project into a Slidev workspace structure.

    171 GitHub stars~954 tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Portaljs Add Dataset

    datopian/portaljs

    Add a dataset (CSV, TSV, JSON, or GeoJSON) to an existing PortalJS portal.

    2.4k GitHub stars~1.6k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Opendocs

    ioteverythin/OpenDocs

    Generates multi-format documentation (Word, PDF, PPTX, Markdown blog post, JIRA ticket, FAQ, changelog, LaTeX, social snippet, architecture diagram) from a GitHub README, npm package, local Markdown…

    233 GitHub stars~746 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Jpage

    code2rich/jpage

    即页(jpage)统一技能:生成 HTML/Markdown 内容、制作 reveal.js 幻灯片、使用内容模板市场风格、上传到即页并管理文件。所有内容生产与文件管理操作都通过本技能完成。

    175 GitHub stars~3.2k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes

More from openclaw/clawhub

All 57 skills in this repo
  • Creates and manages Axiom monitors and notifiers end to end through the v2 API, with scripts for each CRUD operation and a recommended create-validate-tune workflow.

    9.5k GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Axiom Dashboard Builder

    openclaw/clawhub

    Designs and deploys Axiom dashboards through the API, choosing chart types and writing APL or metrics queries, with templates and migration notes for Splunk and Grafana.

    9.5k GitHub stars~4.9k tokensUpdated yesterday
    Auto-check passed
  • Axiom Cost Control

    openclaw/clawhub

    Finds unused data in Axiom by analyzing query patterns, then deploys a cost dashboard and ingest monitors to keep spend under the contract limit.

    9.5k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Axiom Metrics Query

    openclaw/clawhub

    Explores and queries OpenTelemetry metrics in Axiom MetricsDB, listing datasets, metrics and tags first and picking the right aggregation for each metric's type.

    9.5k GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • Axiom SRE Investigator

    openclaw/clawhub

    Investigates incidents and production problems with hypothesis-driven debugging, queries Axiom observability data when available, and keeps secrets out of commands and output.

    9.5k GitHub stars~7.1k tokensUpdated yesterday
    Auto-check passed
  • Axiom Eval Writer

    openclaw/clawhub

    Scaffolds evaluation suites for the Axiom AI SDK: eval files, scorers, flag schemas and axiom.config.ts, generated from plain descriptions of an AI capability.

    9.5k GitHub stars~4.1k tokensUpdated yesterday
    Auto-check: warnings

Works with

Questions about Convex Docs

What does Convex Docs do?

Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check nodemodules types, freshness hierarchy — instead of writing a…. Convex Docs is an agent skill from openclaw/clawhub. Pull version-current Convex docs for the version this project uses — pin the installed version, fetch page-as-markdown or check nodemodules types, freshness hierarchy — instead of writing a possibly-stale API from memory.

When should I use Convex Docs?

Convex Docs fits situations like: documents & Office work in your project.

How do I install Convex Docs in Claude Code?

Run `npx skills add openclaw/clawhub --skill convex-docs -a claude-code`. Or copy the skill folder (.agents/skills/convex-docs in openclaw/clawhub) into .claude/skills/convex-docs in your project. Claude Code loads it when a task matches its description.

How do I install Convex Docs in Codex?

Run `npx skills add openclaw/clawhub --skill convex-docs -a codex`. Or copy the skill folder (.agents/skills/convex-docs in openclaw/clawhub) into .agents/skills/convex-docs in your project. Codex loads it when a task matches its description.

Can I use Convex Docs 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 openclaw/clawhub --skill convex-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/convex-docs, .gemini/skills/convex-docs, .github/skills/convex-docs and .opencode/skills/convex-docs in your project.

What does Convex Docs need to run?

Going by SKILL.md and its folder, Convex Docs needs the command-line tools its instructions call (node).

Does Convex Docs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Convex Docs 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 Convex Docs use?

Convex Docs 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 Convex Docs use?

About 837 tokens (SKILL.md is roughly 3.3k 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 Convex Docs?

Skills that share tags, products or a category with Convex Docs: Convex Release Audit (udecode/kitcn, 450 stars), Convex Quickstart (spokvulcan/poker-planning, 114 stars), Slidev Migrate (leochiu-a/slidev-workspace, 171 stars) and Portaljs Add Dataset (datopian/portaljs, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Convex Docs?

openclaw (a GitHub organization) maintains it in openclaw/clawhub, which has 9,489 GitHub stars. The repository holds 57 skills in this directory. The repository was last updated on October 6, 2026.

Source: openclaw/clawhub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.