tinybird-cli-guidelines

Tinybird CLI commands, workflows, and operations. Use when running tb commands, managing local development, deploying, or working with data operations.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

86%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.

A well-organized, token-efficient index skill that points cleanly to one-level-deep rule files and gives a concrete quick-reference command list. The only notable gap is that validation checkpoints for destructive/batch data operations are delegated to rule files rather than surfaced in the overview.

Suggestions

Surface one or two validation checkpoints in the Quick Reference for destructive/batch operations (e.g. 'verify with tb info before tb deploy'; 'preview data before append/replace') to lift workflow clarity.

Add a short note on how to choose among local/branch/cloud workflows (a one-line decision rule) since 'When to Apply' lists them without guidance on picking one.

Dimension	Reasoning	Score
Conciseness	The body is lean and efficient with no padding or explanation of concepts Claude already knows; every section ('When to Apply', 'Rule Files', 'Quick Reference') earns its place, matching the level-5 anchor.	5 / 5
Actionability	The Quick Reference gives concrete executable commands ('tb build', 'tb deploy', 'tb endpoint data <pipe>', 'tb <command> --help'), but as an index skill the bulk of actionable detail lives in the referenced rule files, leaving minor gaps that keep it just below fully copy-paste-ready level 5.	4 / 5
Workflow Clarity	The CLI 4.0 workflow is sequenced (configure dev_mode once -> tb build -> tb deploy) with override guidance, but the body covers destructive/batch operations (append, replace, delete data) only by reference and lacks explicit validation checkpoints in the overview, so it sits at clear-sequence-with-minor-gaps rather than level 5.	4 / 5
Progressive Disclosure	It is a clear overview with well-signaled, one-level-deep references to eleven rules/*.md files, no nesting, and easy navigation, matching the level-5 anchor for an index skill.	5 / 5
	Total	18 / 20 Passed

Description

82%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.

A concise, well-structured description with an explicit 'Use when' trigger clause and clear niche distinctiveness. Its main weakness is specificity: the listed actions ('commands, workflows, and operations') are generic verbs rather than concrete enumerated capabilities.

Suggestions

Replace generic action nouns with concrete capabilities, e.g. 'Append, replace, and delete data; generate mock data; manage tokens and secrets' to lift specificity toward level 4-5.

Add common synonyms or the tool's invocation form (e.g. 'tb CLI', 'Tinybird commands') to broaden natural trigger coverage.

Dimension	Reasoning	Score
Specificity	The description names the domain ('Tinybird CLI commands, workflows, and operations') but the action verbs are generic; it does not enumerate multiple specific concrete actions, so it matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor rather than the multi-action level 4 or 5.	3 / 5
Completeness	It explicitly answers both 'what' (CLI commands, workflows, operations) and 'when' via a concrete 'Use when running tb commands, managing local development, deploying, or working with data operations' trigger clause, matching the level-5 anchor.	5 / 5
Trigger Term Quality	It includes natural phrases users would say ('running tb commands', 'local development', 'deploying', 'data operations') with good keyword coverage, though it omits some synonyms and file/extension-style variations that would push it to 5.	4 / 5
Distinctiveness Conflict Risk	'Tinybird CLI' and 'tb commands' carve a clear niche with distinct triggers and minimal overlap risk with other skills, matching the level-5 anchor.	5 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: MapleTechLabs/maple
Path: .agents/skills/tinybird-cli-guidelines/SKILL.md
Commit: 3cb9193

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.