CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bitquery

Bitquery integration. Manage data, records, and automate workflows. Use when the user wants to interact with Bitquery data.

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/bitquery/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers strong executable guidance — a complete Membrane CLI workflow with connection-state polling, error-state handling, and a proxy fallback — organized in clear sections. Its weaknesses are duplication and placeholder content (the empty "Bitquery Overview" bullets, the repeated action-discovery section), a dangling "Step 2" cross-reference, and the absence of a single concrete Bitquery query example.

Suggestions

Delete the placeholder "Bitquery Overview" bullet list ("- **GraphQL Query** / - **Response**") and the duplicated "Popular actions" section, merging them into one place with an actual example: a real action id plus a sample `--input` GraphQL query and its output.

Fix the broken cross-references: label the section after connection setup as "Step 2" (and "1a"/"1b" consistently), since "skip to **Step 2**" currently points nowhere.

Tighten the intro to one line ("Blockchain data and analytics platform — docs: https://docs.bitquery.io/") and drop the "used by developers, analysts, and researchers" sentence, which adds no actionable information.

DimensionReasoningScore

Conciseness

The command blocks are lean, but there is measurable padding: a two-sentence product intro ("It's used by developers, analysts, and researchers..."), a near-empty placeholder "Bitquery Overview" section ("- **GraphQL Query** / - **Response**"), and duplication — `membrane action list` with the same intent/flags appears in both "Searching for actions" and "Popular actions". This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim level of 4.

3 / 5

Actionability

Concrete, executable commands throughout: `npm install -g @membranehq/cli@latest`, `membrane login complete <code>`, `membrane connection ensure "https://bitquery.io/" --json`, `action run` with `--input '{"key": "value"}'`, and a full proxy flag table. Matches 'Mostly executable guidance; concrete code or commands with minor gaps' — not a 5 because "Popular actions" promises examples but delivers only the generic discovery command, with no concrete Bitquery action id or input example.

4 / 5

Workflow Clarity

A clear install → login → connect → poll → discover → run → proxy sequence with explicit checkpoints: `--wait` long-polling, per-state handling (READY, CLIENT_ACTION_REQUIRED with a re-poll loop, CONFIGURATION_ERROR/SETUP_FAILED → check the error field). Matches 'Clear sequence with most checkpoints present; minor validation gaps' — the gaps are the dangling "skip to **Step 2**" reference (no step is ever labeled Step 2, and "1b" has no "1a") and no error-recovery guidance for failed action runs, which keep it below 5.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so the score rests on the ~140-line body: sections are well-organized, appropriately sized for a single-file integration skill, and the only external pointer (the official docs URL) is one level deep. Matches 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps' — the placeholder "Bitquery Overview" and duplicated discovery section are the minor gaps keeping it from 5.

4 / 5

Total

15

/

20

Passed

Description

57%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description has an explicit 'Use when' clause and names a distinct product niche, but its capability claims are generic integration boilerplate with no concrete Bitquery actions and no natural trigger vocabulary from the blockchain/crypto domain. It reads like a template applied to Bitquery rather than a description written for it.

Suggestions

Replace the generic actions with concrete Bitquery capabilities, e.g. "Run GraphQL queries against blockchain data (EVM, Solana, DEX trades, token transfers) via Bitquery."

Add natural trigger terms and synonyms users would actually say: "blockchain data", "on-chain analytics", "crypto transactions", "DEX trades", "smart contract events".

Make the 'when' clause specific rather than tautological, e.g. "Use when the user wants blockchain/on-chain data, mentions Bitquery, or asks about crypto transactions or DEX volumes."

DimensionReasoningScore

Specificity

"Bitquery integration. Manage data, records, and automate workflows" names the domain but every stated action is generic integration filler — no concrete Bitquery capability (e.g., run GraphQL queries, fetch blockchain transactions) is mentioned, matching the anchor 'Names the domain but actions are minimal or generic'. It is not a 3 because that anchor requires 1-2 concrete actions, and nothing here is concrete.

2 / 5

Completeness

Both parts are present: what ("Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with Bitquery data"), but the 'when' merely restates the product name rather than giving concrete trigger phrases, matching 'Has both what and when; when could be more explicit or specific'. Not a 5 because the trigger clause is tautological rather than concrete; not a 3 because an explicit 'Use when' clause exists.

4 / 5

Trigger Term Quality

"Bitquery" and "data" are relevant keywords a user might say, but common variations and synonyms — "blockchain data", "crypto", "on-chain", "GraphQL", "Web3" — are entirely missing, matching 'Some relevant keywords but missing common variations or synonyms'. Not a 2 because 'Bitquery' is a specific, non-generic product keyword rather than purely generic language.

3 / 5

Distinctiveness Conflict Risk

Bitquery is a distinct named product with a narrow niche, so wrong-skill triggering is unlikely; the only overlap risk comes from the generic "manage data / automate workflows" phrasing shared with many data-integration skills, matching 'Mostly distinct; minor overlap risk'. Not a 5 because the triggers lack concrete phrases beyond the product name itself.

4 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

membranedev/application-skills

Path

skills/bitquery/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.