CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

opensourcefaq

Answer open-source product questions by combining local source-code and documentation research, project framework notes generated by init, DeepWiki repository knowledge, and current web evidence, then save a sourced, diagram-rich Markdown answer to the current project's markdown directory. Use when the user asks about behavior, architecture, internals, configuration, APIs, troubleshooting, performance, operations, extension points, practical reproduction, or version-specific details of one or more open-source projects and provides the question, all relevant local source directories, and DeepWiki repoName values.

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 presents a clear, well-sequenced research-and-write workflow with strong verification checkpoints and concrete commands, but it is noticeably redundant — the practical-reproduction requirements and verification rules each appear in multiple sections — which costs token efficiency. Moving the article template to a reference file would also tighten the single-file structure.

Suggestions

Consolidate the practical-reproduction requirements, currently stated three times (Workflow step 5 bullet, "Practical Reproduction Requirements" section, and the "实操示例" template entry), into the single dedicated section.

Merge "Validation Rules" with the Workflow step 6 verification guidance so each verification rule is stated once.

Trim generic reasoning advice in Workflow step 2 (e.g. "Prefer the simplest explanation that source code and docs support") that Claude already applies, and consider moving the Article Structure template to a references/ file.

DimensionReasoningScore

Conciseness

Mostly efficient and free of concept explanations, but materially redundant: practical-reproduction requirements are stated three times (Workflow step 5 bullet, the entire "Practical Reproduction Requirements" section, and the "实操示例" template section), verification guidance is duplicated between Workflow step 6 and "Validation Rules", and step 2 includes generic reasoning advice Claude already applies ("Prefer the simplest explanation that source code and docs support"). This fits the 3 anchor (could be tightened) better than the 4 anchor (minor instances), because trimming the duplicates would remove whole sections, not sentences.

3 / 5

Actionability

Concrete executable anchors are present — `git -C <dir> rev-parse --abbrev-ref HEAD`, `git -C <dir> rev-parse HEAD`, `rg`, `rg --files`, the filename pattern `markdown/opensourcefaq-<topic>.md`, and a complete article skeleton — but much of the guidance is necessarily open-ended direction ("Search the web for relevant articles...") with minor gaps, matching the 4 anchor rather than the fully copy-paste-ready 5 anchor.

4 / 5

Workflow Clarity

Six clearly sequenced steps with an explicit "Verify before finalizing" step, a "Validation Rules" checklist, feedback loops for error recovery ("When code and docs disagree, verify against the code path"; "If a claim cannot be verified, mark it as an inference"), and a code-wins conflict-resolution rule, matching the 5 anchor.

5 / 5

Progressive Disclosure

No bundle files exist, and the body is well-sectioned with clear headers and no nested references. Minor gap: the ~40-line "Article Structure" output template is inline content that arguably belongs in a reference file, keeping it at 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

92%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 strong description in third-person voice with a comprehensive capability statement and an explicit, trigger-rich 'Use when' clause. The only gap is modest synonym coverage of natural user phrasings in the trigger list.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "combining local source-code and documentation research, project framework notes generated by init, DeepWiki repository knowledge, and current web evidence, then save a sourced, diagram-rich Markdown answer to the current project's markdown directory" — covering the full pipeline comprehensively with no filler.

5 / 5

Completeness

Explicitly answers both what ("Answer open-source product questions by combining... then save a sourced, diagram-rich Markdown answer") and when ("Use when the user asks about behavior, architecture, internals...") with concrete trigger phrases, exactly matching the 5 anchor.

5 / 5

Trigger Term Quality

Good keyword coverage with concrete trigger categories ("behavior, architecture, internals, configuration, APIs, troubleshooting, performance, operations, extension points, practical reproduction, or version-specific details"), but a few natural user phrasings are missing (e.g. "how does", "why does", "explain how X works", "debug"). Not the 5 anchor because the rubric expects synonyms of natural phrasing, and the description leans on a single enumerated list rather than varied wording.

4 / 5

Distinctiveness Conflict Risk

Clear niche (source-backed, DeepWiki-assisted answers about open-source project internals) with distinct triggers gated on user-provided "local source directories" and "DeepWiki repoName values", giving minimal overlap with generic research or documentation skills.

5 / 5

Total

19

/

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

digoal/blog

Path

skills/opensourcefaq/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.