database-foundation-course-writer

Write Chinese "数据库筑基课" Markdown articles for database architects, DBAs, and application developers. Use when the user provides a database foundation article title and references such as technical docs, product manuals, open-source repositories, DeepWiki pages, papers, source code, or related blog posts, and wants a rigorous, SVG-rich, practice-oriented GitHub-renderable Markdown article saved as a .md file.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

70%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 skill has an exceptionally clear, validated workflow and a concrete article template, but it is fairly verbose with repeated guidance and keeps all detail inlined in one file rather than using progressive disclosure via bundled reference files.

Suggestions

Extract the long Article Structure template, Topic Guidance, and SVG Diagram Policy into separate reference files (e.g. references/article-structure.md, references/svg-policy.md) and link to them from SKILL.md to improve progressive disclosure.

De-duplicate repeated guidance (diagram-purpose rules appear in Workflow, SVG Diagram Policy, Style Rules, and the Validation Checklist) to tighten token efficiency.

Add at least one fully runnable SQL/EXPLAIN example or a complete sample SVG to lift actionability from templates to copy-paste-ready artifacts.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and well-organized but is quite long, repeating guidance across Workflow, Article Structure, Topic Guidance, SVG Diagram Policy, Style Rules, and Validation Checklist (e.g. 'every diagram must explain structure/flow/comparison' appears in multiple sections), so it could be tightened.	3 / 5
Actionability	Provides a concrete article-structure template, an SVG image-syntax example, a comparison-table template, and a validation checklist; however examples are template scaffolding rather than fully executable runnable artifacts, and SQL/EXPLAIN examples are described rather than shown.	4 / 5
Workflow Clarity	An explicit 8-step Workflow is sequenced with a validation checkpoint ('Do not save until the article has passed the validation checklist'), a full Validation Checklist, and a feedback loop (validate then save only on pass), satisfying the destructive/batch validation requirement.	5 / 5
Progressive Disclosure	Content is organized into clear sections but everything lives in a single SKILL.md with no references/ or assets/ bundle files and no one-level-deep links; the large article-structure template and topic guidance that could be split into reference files are inlined.	3 / 5
	Total	15 / 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.

The description is highly specific, complete, and distinctive, clearly stating both what it does and when to use it with concrete trigger phrases. Trigger-term naturalness is slightly dampened by the specialized Chinese genre label and dense enumerations rather than everyday synonyms.

Suggestions

Lead with a short, plain-language trigger phrase (e.g. 'Use when the user asks for a 数据库筑基课 article given a title and reference docs') so the trigger reads like something a user would actually say.

Consider trimming the long reference-type enumeration in the description and moving the full list into the body to keep the trigger crisp.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions (write rigorous SVG-rich practice-oriented Markdown articles saved as .md files) and enumerates exact reference types (technical docs, product manuals, open-source repositories, DeepWiki pages, papers, source code, blog posts) plus the target output format, giving comprehensive coverage.	5 / 5
Completeness	Explicitly answers both 'what' (write Chinese 数据库筑基课 Markdown articles for architects/DBAs/developers) and 'when' ('Use when the user provides a database foundation article title and references such as...'), with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural phrases a user might say ('database foundation article title', 'references such as... papers, source code', 'rigorous... Markdown article'), but the highly specific Chinese genre term '数据库筑基课' and the long enumerations are more technical than the common synonyms a typical user would spontaneously say.	4 / 5
Distinctiveness Conflict Risk	The narrow niche (database-foundation-course Chinese articles with SVG figures) and distinctive trigger (article title plus technical references) make it unlikely to fire for unrelated skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
relative_links	Relative link issues: 3 missing	Warning

	Total	15 / 16 Passed

Repository: digoal/blog
Path: skills/database-foundation-course-writer/SKILL.md
Commit: 3b9c83d

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.