CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

opensourcefaq

解答与开源产品有关的深度技术问题,输出图文并茂的 Markdown 技术文章。触发条件:用户提出与开源项目(如 PostgreSQL、Redis、Kafka、Kubernetes、ClickHouse、Flink 等)相关的技术问题,并提供源码目录或 URL、deepwiki repo 名称。即使用户只说"帮我解答这个开源问题"或"分析一下这个项目的某个机制",也应使用本 skill。输出文章保存到项目 markdown/ 目录,要求直击问题、图文并茂、有实操细节和原理分析。

67

Quality

84%

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

77%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 well-engineered workflow document: strictly sequenced phases, exact tool names, explicit validation checkpoints with a source-vs-deepwiki precedence rule, and closing checklists. Its weakest point is structure — everything lives inline in one ~240-line SKILL.md with no one-level-deep reference files, which both lengthens the always-loaded context and leaves no place for extended templates or example output.

Suggestions

Move the article-structure template, 图表规范, and 实操演练规范 (Phase 3 sub-sections) into a single references/article-format.md and reference it from a short '输出格式' section in SKILL.md, cutting the always-loaded body to roughly half.

Add one compact worked example (e.g., a short sample mermaid diagram and one sample deepwiki:ask_question call with its expected answer shape) so the 实操 and question-asking steps are copy-paste concrete rather than template-only.

DimensionReasoningScore

Conciseness

The body is almost entirely prescriptive instruction (phases, tool names, templates, checklists) with essentially no explanation of concepts Claude already knows, so it sits at 'efficient; minor instances that could be trimmed'. Not a 5 because the figure requirements are stated twice (body line '包含 text、mermaid、svg 三种图表形式中的至少两种' plus the final checklist), and the article-structure and 实操 templates are somewhat padded with parenthetical restatements.

4 / 5

Actionability

Gives concrete, executable guidance: exact tool calls by name (`grep -rn`/`find`/`cat` for local paths, `web_fetch`, `deepwiki:read_wiki_structure`, `deepwiki:read_wiki_contents`, `deepwiki:ask_question`, `web_search`), explicit keep/drop source filters, a full article skeleton, output naming rules (lowercase hyphenated paths under markdown/), and checklist items. Not a 5 because there is no single concrete worked example (e.g., a filled-in mermaid diagram, a sample deepwiki question, or one completed 实操 section), leaving a few execution details implicit.

4 / 5

Workflow Clarity

Four strictly ordered phases with a Phase 0 input-confirmation gate ('如有缺失,简短追问,不要跳过'), explicit validation checkpoints in Phase 4 (source cross-verification, re-querying deepwiki about the article's own conclusions), a feedback loop for error recovery ('如有出入,更新文章(以源码为准,DeepWiki 为辅)'), and a final checklist. This matches the 5 anchor — clear sequence, explicit validation, feedback loops, and checklists — and is above the 4 anchor where checkpoints are only mostly present.

5 / 5

Progressive Disclosure

The single file is well-sectioned with clear headers, but there are no bundle files at all and ~240 lines are all inline, including reference-shaped material (the article-structure template, 图表规范, and 实操演练规范) that would fit naturally in separate reference files a level deep. That matches 'some structure but could be better organized' rather than a 4, since content that plausibly belongs in separate files is inlined with no signaled references anywhere.

3 / 5

Total

16

/

20

Passed

Description

83%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 that clearly states what the skill does and gives explicit, well-reasoned trigger guidance including vague user phrasings and concrete project names. Main gaps are English-language trigger synonyms and the absence of the skill's internal capabilities (deepwiki MCP tools, source-search workflow) in the capability list.

DimensionReasoningScore

Specificity

Names the domain (open-source projects, with PostgreSQL/Redis/Kafka/Kubernetes/ClickHouse/Flink examples) and several concrete actions: answering deep technical questions, producing illustrated Markdown articles with hands-on details and principle analysis, and saving output to the markdown/ directory. It falls short of a 5 because the actions stay at the output level and don't enumerate the distinct capabilities (source-code search, deepwiki retrieval, web filtering, verification) that the skill actually performs.

4 / 5

Completeness

Explicitly answers both halves: 'what' (answers deep technical questions about open-source products and outputs illustrated Markdown articles saved to markdown/) and 'when' via a dedicated 触发条件 clause with concrete trigger phrases, explicitly covering the vague-but-sufficient cases. This matches the 5 anchor (clear what AND when with concrete trigger phrases) and is clearly above the 4 anchor where 'when' is present but loose.

5 / 5

Trigger Term Quality

Includes natural user phrasings users would actually say ("帮我解答这个开源问题", "分析一下这个项目的某个机制") plus six concrete project names, which is good coverage. Not a 5 because common variations like English phrasings ("how does X work", "why does X..."), or generic terms like source-code analysis / internals / 源码分析 are missing.

4 / 5

Distinctiveness Conflict Risk

The niche (deep source-level Q&A on specific open-source projects, requiring a source directory/URL or deepwiki repo name) is fairly distinct with named project triggers. Not a 5 because it could still overlap with general code-analysis, research, or documentation skills when a user asks a broad technical question about one of the listed projects without providing source access.

4 / 5

Total

17

/

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