CtrlK
BlogDocsLog inGet started
Tessl Logo

sourcegraph

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

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

82%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 well-structured, highly actionable Membrane CLI integration guide with copy-paste commands and clear state-driven checkpoints. Its main weaknesses are minor verbosity in the intro/auth prose, a dangling "Step 2" reference, and some redundant action-listing sections.

Suggestions

Resolve the dangling "Step 2" reference by adding an explicit numbered "## Step 2: Search and run actions" header, or remove the cross-reference.

Consolidate the overlapping "Searching for actions" and "Popular actions" sections into one, keeping the `--intent` discovery command and the run examples together.

Trim padded phrasing (e.g. "so you can focus on the integration logic rather than auth plumbing") and the thin "Use action names and parameters as needed." overview line.

DimensionReasoningScore

Conciseness

The body is dominated by lean, executable commands and a flag table, with only minor over-explanation such as "so you can focus on the integration logic rather than auth plumbing" and the Sourcegraph introductory paragraph. It fits the 'efficient; minor instances of over-explanation that could be trimmed' anchor. It is not a 5 because those padded phrases and the thin Overview list ("Use action names and parameters as needed.") keep it from being uniformly lean.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready — concrete `membrane`/`npx` commands for login, connection ensure, polling, action list, action run with JSON input, and proxy requests with a flag table — covering the common cases. This matches the 'fully executable; copy-paste ready' anchor exactly.

5 / 5

Workflow Clarity

The connect → poll-until-READY → search → run → proxy sequence is clear and uses explicit state-based checkpoints (READY, BUILDING, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) as a validation/feedback loop. It is not a 5 because the body references "Step 2" with no matching Step 2 header (only "#### 1b"), and there is no explicit fix-and-retry loop for CONFIGURATION_ERROR beyond reading the error field.

4 / 5

Progressive Disclosure

With no bundle files present, the single SKILL.md is organized into clear, well-signaled sections (Overview, Working with Sourcegraph, Install, Authentication, Connecting, Searching, Popular actions, Proxy, Best practices) appropriate for a CLI guide. It is not a 5 because "Searching for actions" and "Popular actions" overlap redundantly and the proxy/clientAction detail could plausibly live in a separate reference, leaving minor organization gaps.

4 / 5

Total

17

/

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 correctly uses third-person voice and includes an explicit "Use when..." trigger, but its capability statement is generic ("manage data, records, and automate workflows") rather than naming concrete Sourcegraph operations. Distinctiveness is carried almost entirely by the product name.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete Sourcegraph actions such as "search code across codebases, browse files and repositories, and find references".

Add natural trigger terms users say, e.g. "Use when the user wants to search code, find usages, or explore a codebase with Sourcegraph".

Mention file/extension or feature cues (e.g. "code search", "symbol lookup") to broaden trigger-term coverage beyond the product name.

DimensionReasoningScore

Specificity

The description names the domain ("Sourcegraph integration") but the stated actions are generic and minimal — "Manage data, records, and automate workflows" — with no concrete operations, matching the anchor that names a domain with minimal/generic actions. It is not a 3 because it lists no genuinely concrete Sourcegraph actions (e.g. code search, file lookup) that would move it toward '1-2 concrete actions'.

2 / 5

Completeness

Both a "what" ("Manage data, records, and automate workflows") and an explicit "when" ("Use when the user wants to interact with Sourcegraph data") are present; the "when" is reasonably explicit while the "what" stays vague, fitting the anchor where both exist but one could be more specific. It is not a 3 because the trigger guidance is explicit rather than missing/weakly implied, and not a 5 because the "what" lacks concrete capability detail.

4 / 5

Trigger Term Quality

"Sourcegraph" and "interact with Sourcegraph data" provide a relevant natural keyword, but common variations a user would actually say (e.g. "code search", "codebase", "find code") are absent, matching the anchor for some relevant keywords missing synonyms. It is not a 4 because keyword coverage is thin beyond the product name.

3 / 5

Distinctiveness Conflict Risk

"Sourcegraph" is a clearly named, distinct niche with a product-specific trigger, giving low conflict risk, but the accompanying generic phrasing ("manage data, records") leaves minor overlap with broad data-management skills, matching the 'mostly distinct; minor overlap risk' anchor. It is not a 5 because the surrounding action language is not tightly scoped to Sourcegraph's distinct purpose.

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.

Validation15 / 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
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.