CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-code-statusline-development

This skill should be used when the user asks to "create a statusline", "customize the status line", "add a custom prompt", or mentions Claude Code statusline. Also suggest when the user wants to display git branch, context usage, model name, or session costs at the bottom of Claude Code.

87

1.50x
Quality

85%

Does it follow best practices?

Impact

99%

1.50x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

90%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 lean, highly actionable body that appropriately keeps only quick-reference material in SKILL.md and defers detail to well-signaled, one-level-deep reference files. The only notable gaps are that the workflow steps are presented as sections rather than a sequence with an explicit test checkpoint, and one bundled reference file is orphaned (unlinked from SKILL.md).

Suggestions

Link example-git-context-remaining.md from the Quick Reference list (or fold its content into an existing example) so every bundle file is discoverable from SKILL.md.

Promote the mock-JSON test from a "Tips" bullet to an explicit step after the Script Template so validation is a checkpoint rather than an optional suggestion.

DimensionReasoningScore

Conciseness

Nearly every line carries non-obvious information Claude would not already know — "Updates run at most every 300ms", "First line of stdout becomes the status line text", "JSON context passed via stdin", "chmod +x", the mock-JSON test command, and the no-restart note. There is no padding, no explanation of basic concepts, and the field table stays minimal while deferring the full schema to a reference file; every token earns its place.

5 / 5

Actionability

The guidance is fully executable and copy-paste ready: the exact `.claude/settings.json` block, a working bash template using jq and tput, the `chmod +x` command, and a runnable test command (`echo '{"model":{"display_name":"Test"}}' | ./statusline.sh`). Common cases beyond the simple template (git-aware, context usage, cost tracking) are covered by named example reference files, so there are no gaps in covering the common cases.

5 / 5

Workflow Clarity

All steps are present and unambiguous — write the script from the template, make it executable, add the settings.json config, test with mock JSON, and inform the user that no restart is needed — and the mock-JSON test acts as a validation checkpoint (this is not a destructive or batch skill, so no cap applies). Not 5 because the steps are laid out as parallel sections rather than an explicitly sequenced workflow, and testing appears under "Tips" as an optional suggestion rather than an explicit checkpoint.

4 / 5

Progressive Disclosure

Good structure: a mandatory "You MUST read the reference files" section lists five clearly described, one-level-deep reference files (all verified to exist with no nested references), and the quick-reference field table appropriately defers to json-schema.md. Not 5 because the bundle contains a sixth reference file, example-git-context-remaining.md, that is never linked from SKILL.md, leaving it undiscoverable from the overview — a minor organization gap.

4 / 5

Total

18

/

20

Passed

Description

75%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 solidly written, trigger-focused description with explicit and varied use-when guidance, both spellings of the key term, and concrete display-target triggers. Its main weaknesses are the absence of a direct third-person capability statement (the "what" exists only as quoted user actions) and one misfire-prone trigger phrase ("add a custom prompt").

Suggestions

Open with a third-person capability statement before the use-when clause, e.g., "Creates custom status lines that display git branch, context usage, model name, and session costs at the bottom of Claude Code. Use when the user asks to create or customize a statusline."

Replace or drop "add a custom prompt" — users asking for a custom prompt typically mean prompt or system-prompt customization, not a statusline, so this trigger invites the wrong skill; "customize the status line" already covers the intended request.

Add a few missing natural variations such as "status bar", "show token usage", or "status line script" to broaden trigger-term coverage toward comprehensive.

DimensionReasoningScore

Specificity

The description names the domain and several concrete actions — "create a statusline", "customize the status line", "display git branch, context usage, model name, or session costs" — with only minor coverage gaps. It is not 3 (more than 1-2 concrete actions are listed) but not 5 because the actions appear only as quoted user-trigger phrasings; the skill never states its own capabilities declaratively (e.g., "Create custom status lines that display contextual information").

4 / 5

Completeness

The "when" is explicit and rich ("This skill should be used when the user asks to... Also suggest when the user wants to display..."), satisfying the use-when requirement, and the "what" is legible through the quoted actions. Not 5 because the "what" is never directly stated as a capability statement — it is only implied via trigger phrases — which mirrors anchor 4's one-side-could-be-more-explicit profile rather than a fully explicit what-and-when.

4 / 5

Trigger Term Quality

Good natural keyword coverage including both spellings ("statusline" / "the status line") and data-type triggers users would actually say ("git branch", "context usage", "model name", "session costs"). Not 5 because a few natural variations are missing (e.g., "status bar", "show token usage") and "add a custom prompt" is a phrase users would more naturally use for prompt customization than for a statusline.

4 / 5

Distinctiveness Conflict Risk

"Claude Code statusline" carves a clear niche with distinct triggers, so conflict risk is low overall. Not 5 because "add a custom prompt" creates minor overlap risk with closely related prompt/customization skills — a user asking to add a custom prompt usually means something other than a statusline.

4 / 5

Total

16

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

dwmkerr/claude-toolkit

Path

plugins/toolkit/skills/claude-code-statusline-development/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.