CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cli-anything-firefly-iii

Firefly III CLI - Personal finance management via CLI-Anything

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./firefly-iii/agent-harness/skills/cli-anything-firefly-iii/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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 is a strong, highly actionable CLI reference full of executable commands, clear workflows, and useful troubleshooting. Its main weaknesses are the missing validation/verification steps around destructive and create operations (capping workflow clarity) and a monolithic single-file structure that inlines ~280 lines of command reference that would serve better as split-out reference files.

Suggestions

Add validation checkpoints to destructive and create workflows: e.g. 'After create, run `transactions get --id <new_id>` to confirm the amount and accounts' and 'Before delete, run `get --id` to confirm the target, then verify deletion via list'.

Move the per-group usage examples, preset catalog, and troubleshooting into one-level-deep reference files (e.g. references/commands.md, references/troubleshooting.md), keeping SKILL.md as a lean overview with a quick-start example.

Trim or cut the 'Comparison with MCP Version' table and the generic 'Error Handling' list, which mostly restate obvious checks or provide background Claude does not need.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands, tables, and workflows and largely assumes Claude's competence — e.g. the command group table and 'Record Expense' workflow are pure command sequences with no concept tutorials. Minor trimmable padding exists: the 'Comparison with MCP Version' table, the generic 'Error Handling' list ('Check if ID is correct'), and 'Best Practices' bullets mostly restate earlier guidance, keeping it just below the lean anchor-5 example.

4 / 5

Actionability

Nearly every section gives copy-paste-ready, fully executable commands covering the common cases: account/transaction CRUD with real flags ('--json accounts create --name "Cash" --type asset --currency-code USD'), dated insight reports, search, export, presets, and auth configuration via env vars or CLI args. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The 'Common Workflows' section sequences steps clearly (check connection → list → create) and even opens with 'Call info status first to check connection', so it is above the rough-sequence anchors. However, destructive operations (delete account/transaction) and create operations appear with no verification or validation steps (e.g. re-reading a transaction after creating it, confirming before delete), and the rubric's guideline caps workflows involving destructive or batch operations without validation at 3.

3 / 5

Progressive Disclosure

The single SKILL.md is well-sectioned with headers and a command-group table, but it is ~280 lines with no bundle files and no external references — the full per-command usage examples, preset catalog, and troubleshooting reference all live inline, matching anchor 3's '[200 lines of API reference that could be in a separate file]'. It is not a 4 because content that clearly belongs in separate reference files (full usage examples per group, troubleshooting) is inlined rather than split out, and the under-50-lines exception for scoring higher does not apply.

3 / 5

Total

15

/

20

Passed

Description

48%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 identifies a distinct, specific product niche (Firefly III CLI) but is a bare title-like string: it enumerates no concrete capabilities and provides no trigger guidance for when the skill should be used. It functions as a name, not a decision-useful description.

Suggestions

List concrete capabilities in the description, e.g. 'Create, list, and delete transactions, accounts, budgets, and categories; run expense/income insights and reports; export data from a Firefly III instance.'

Add an explicit trigger clause, e.g. 'Use when the user mentions Firefly III, personal finance management, tracking expenses or budgets, or asks to record or report transactions.'

Include natural synonyms and keyword variations users would actually say (transactions, budgets, bills, expense tracking, savings/piggy banks) to improve trigger matching.

DimensionReasoningScore

Specificity

The description names the domain ("Firefly III CLI - Personal finance management via CLI-Anything") but lists zero concrete actions — no mention of managing transactions, budgets, accounts, or generating reports. This matches the anchor 'Names the domain but actions are minimal or generic'; it is not a 1 because the domain itself (Firefly III, personal finance) is specifically named, and not a 3 because no concrete capability is enumerated.

2 / 5

Completeness

The 'what' is present at domain level (a CLI for Firefly III personal finance management), but there is no 'when' clause whatsoever — no 'Use when...' guidance or equivalent trigger phrasing, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is clearer than vague examples like 'Use when working with documents', and not a 4 because 'when' is entirely absent rather than just under-specified.

3 / 5

Trigger Term Quality

"Firefly III" and "personal finance management" are relevant terms a user would plausibly say, but the description misses common natural variations and synonyms like "budget", "transactions", "expenses", or "accounting". This sits at 'Some relevant keywords but missing common variations or synonyms' — better than generic one-word descriptions (2), but not the good coverage of a 4.

3 / 5

Distinctiveness Conflict Risk

"Firefly III" is a specific product name giving this a clear niche with minimal conflict risk against unrelated skills, matching 'Mostly distinct; minor overlap risk'. It is not a 5 because the generic phrase "Personal finance management" could attract requests intended for other finance tools or skills, and the description lacks the concrete trigger phrases of the anchor-5 example.

4 / 5

Total

12

/

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

HKUDS/CLI-Anything

Path

firefly-iii/agent-harness/skills/cli-anything-firefly-iii/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.