CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

btca-local

Invoke this skill when the user says "use btca"

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/btca-local/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 content communicates a usable workflow with clear invocation modes and a concrete startup template, but execution details are thin (no commands for the load/search steps), validation is absent, and the custom pseudo-XML structure — including an unclosed <workflow> tag — makes the document fragile to parse. Converting the tag soup into ordinary markdown sections with concrete commands would lift most dimensions.

Suggestions

Replace the custom <guidelines>/<workflow>/<end_goal> tags with standard markdown lists and headings, and fix the malformed second '<workflow>' tag on line 40 (it should be '</workflow>') so the step container is well-formed.

Add concrete commands to the workflow steps — e.g. 'git clone --depth 1 <url> ~/.btca/agent/sandbox/<repo>' for load and 'git pull --ff-only' for update — so the load step is executable rather than descriptive.

Add a validation checkpoint before search, e.g. confirm the repo directory exists and is a git repository ('test -d ~/.btca/agent/sandbox/<repo>/.git'), and specify which tools (grep/rg, file listing) to use for the search step.

Consolidate the three 'Startup Cases' into the workflow section or a single 'Invocation modes' list so all behavioral rules live in one coherent structure.

DimensionReasoningScore

Conciseness

The body is lean for its scope: no explanations of concepts Claude already knows, and content is limited to workflow rules and invocation cases. Minor instances of chatty filler could be trimmed ('this one's simple, simply answer the users prompt', 'almost as if a terminal app was booted up'), matching 'Efficient; minor instances of over-explanation that could be trimmed' rather than anchor 5 where every token earns its place.

4 / 5

Actionability

Concrete elements exist — the exact sandbox path '~/.btca/agent/sandbox', a default-branch clone rule, and a copy-paste startup output template — but the core workflow offers no executable commands for cloning, updating, or searching ('search the repo for the information you need', 'update them'), so guidance is incomplete as in 'Some concrete guidance but incomplete'. It is not anchor 4 because none of the load/search steps could be executed as written without Claude supplying all specifics itself.

3 / 5

Workflow Clarity

A real three-step sequence exists (work dir setup → load → search) plus three clearly separated invocation cases, but there are no validation checkpoints (e.g. confirming a clone succeeded or a repo exists before searching) and the structure is broken by a malformed tag — line 40 opens a second '<workflow>' instead of closing the first, corrupting the step container. This lands on 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'; it is above anchor 2 because the sequence is coherent and the startup states are well-defined.

3 / 5

Progressive Disclosure

The skill has no bundle files and is short enough that a single SKILL.md is arguably appropriate, but the in-file organization undercuts navigation: custom XML pseudo-tags (<guidelines>, <workflow>, <end_goal>) are mixed with markdown headings, one tag is malformed, and the 'Startup Cases' section sits outside the tag structure. This matches 'Some structure but could be better organized'; it is not anchor 4 because the structure a reader must parse is inconsistent rather than having only minor gaps.

3 / 5

Total

13

/

20

Passed

Description

35%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 is a bare trigger clause with zero capability information. A user or Claude scanning skill descriptions would learn when to invoke it but nothing about what it does, which also limits its discoverability for users who describe their need rather than naming the app. Adding a one-phrase capability statement ('Searches git repos cloned locally...') would move it into the good-example range.

Suggestions

State the core capability in the description, e.g. 'Searches git repos cloned on this machine and answers questions with cited code snippets. Invoke when the user says "use btca" or asks to search a local repo.'

Add trigger variations beyond the literal phrase — e.g. 'search local git repos', 'btca' — so users who describe the need rather than naming the app can still discover the skill.

Use third person and keep it to one or two sentences; the body already contains the workflow, so the description only needs what + when.

DimensionReasoningScore

Specificity

The description 'Invoke this skill when the user says "use btca"' names no capability of the skill at all — not even a domain — so it matches the anchor 'Entirely vague; no concrete actions; pure abstract language'. The only action described is the invocation itself, not anything the skill does.

1 / 5

Completeness

Only the 'when' half is present (an explicit trigger clause) while the 'what' — searching git repos cloned on this machine — is entirely absent, exactly matching the anchor 'only "when" is present without "what"'. It is not a 3 because there is no 'what' stated or even weakly implied, and not a 1 because the 'when' is explicit and specific.

2 / 5

Trigger Term Quality

'use btca' is a natural phrase a user of this app would say, so a relevant keyword exists, but coverage stops there — no synonyms or related terms (search, git, repos, local) that users might use. This fits 'Some relevant keywords but missing common variations or synonyms'; it is above anchor 2 because the one trigger present is specific and natural rather than generic.

3 / 5

Distinctiveness Conflict Risk

'use btca' is a unique, unambiguous trigger phrase unlikely to fire for any other skill, giving minor conflict risk ('Mostly distinct; minor overlap risk'). It falls short of anchor 5 because a distinct trigger alone does not establish a clear niche — with no capability described, the skill cannot be meaningfully compared against or distinguished from related search/repo skills.

4 / 5

Total

10

/

20

Passed

Validation

100%

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

stickerdaniel/linkedin-mcp-server

Path

.agents/skills/btca-local/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.