CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

68

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

81%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-structured, highly directive skill body: a clear 8-step workflow gated by an explicit validation checklist, concrete article and table templates, and precise GitHub-safe SVG requirements. The main weaknesses are mild — some duplicated guidance (SVG rules appear twice) and a few underspecified details like slug derivation and the outline location — plus all content living in one file rather than splitting templates into reference files.

Suggestions

Deduplicate the SVG guidance: state the 'no decorative diagrams / must explain structure, flow, comparison, or decision logic' rule and the GitHub-safety constraints once in SVG Diagram Policy, and have the Validation Checklist reference them briefly instead of restating them.

Make the underspecified details concrete: give a rule for deriving '<article-slug>' from a Chinese title (e.g., romanized/English slug conventions) and point to where the 'database foundation course outline' to link back to is found.

Consider moving the full article skeleton, comparison-table template, and per-topic coverage lists into a references/ file, keeping SKILL.md as a lean overview — this would also improve token efficiency on invocation.

DimensionReasoningScore

Conciseness

The body is directive throughout with no explanation of concepts Claude already knows, but there is repeated material: 'Every SVG must explain structure, flow, comparison, or decision logic' appears in both SVG Diagram Policy ('Avoid decorative SVGs. Every SVG must explain...') and Style Rules ('Every diagram must explain...'), and the SVG safety rules (no JavaScript/foreignObject/external assets) are stated in the SVG Diagram Policy and restated in the Validation Checklist. Efficient with minor trimming opportunities — a 4, not a 5, and far from the noticeable padding of a 3.

4 / 5

Actionability

Highly actionable for a writing skill: a copy-paste article skeleton, a concrete comparison-table template with exact column headers, exact Markdown image syntax, and precise SVG requirements (xmlns, viewBox, width, height, title, desc). A few details remain underspecified — how to derive '<article-slug>' from a Chinese title, and the course outline to 'link back to' is referenced without a location — so it sits at 'mostly executable guidance with minor gaps' rather than fully covering the common cases.

4 / 5

Workflow Clarity

The 8-step Workflow has an explicit validation step ('Validate logic, examples, citations, Markdown rendering, relative image links, and SVG visibility'), the Output section mandates 'Do not save until the article has passed the validation checklist', and a full 16-item Validation Checklist closes the loop before saving. This matches the 5 anchor: clear sequence with explicit validation and a checkpoint before the final write.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so everything lives in a single ~220-line SKILL.md. Section structure is clean and navigable (Overview, Inputs, Output, Workflow, Article Structure, Topic Guidance, SVG Diagram Policy, Validation Checklist), but content such as the full article skeleton, the comparison table template, or the per-topic coverage guidance could be offloaded to reference files to keep the main file leaner — good structure with minor organization gaps, i.e., a 4.

4 / 5

Total

17

/

20

Passed

Description

87%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: third-person voice, explicit and comprehensive 'Use when' trigger clause, concrete output specification, and a clearly distinct niche. Keyword coverage is good but a few natural user phrasings (synonyms, Chinese variants, '.md') are missing, keeping trigger_term_quality and specificity at 4 rather than 5.

DimensionReasoningScore

Specificity

Concrete actions and attributes are named — 'Write Chinese "数据库筑基课" Markdown articles', 'rigorous, SVG-rich, practice-oriented GitHub-renderable Markdown article saved as a .md file', with a defined audience (architects, DBAs, application developers). It is largely one verb ('write') qualified by output characteristics rather than the multiple distinct concrete actions of a 5, so 4 fits: specific with minor coverage gaps.

4 / 5

Completeness

Both halves are explicit: the 'what' is 'Write Chinese "数据库筑基课" Markdown articles... rigorous, SVG-rich, practice-oriented GitHub-renderable Markdown article saved as a .md file', and the 'when' is a full 'Use when the user provides a database foundation article title and references... and wants...' clause with concrete triggers. This matches the 5 anchor's what-and-when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The 'Use when' clause enumerates natural inputs users would mention: 'technical docs, product manuals, open-source repositories, DeepWiki pages, papers, source code, or related blog posts' plus 'database foundation article title'. Coverage is good but misses some common phrasings and synonyms (e.g., 'write an article', '翻译', Chinese phrasings, .md), so it fits 'good keyword coverage; a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The distinctive series name (数据库筑基课), Chinese-language requirement, database-domain focus, and SVG-rich/GitHub-renderable output constraints give it a clear niche with minimal overlap with generic writing or documentation skills. Triggers (title + reference materials provided) would not naturally fire for other skills.

5 / 5

Total

18

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository
digoal/blog
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.