CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-article

Review a docs article

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.github/skills/review-article/SKILL.md
SKILL.md
Quality
Evals
Security

Review a documentation article by completing these tasks:

  • Review the article for adherence to our documentation writing style guidelines.

  • Validate technical accuracy:

    • Verify all code samples are syntactically correct and follow best practices
    • Test command-line instructions and procedures
    • Confirm API references and method names are current
    • Check that screenshots and images are up-to-date
  • Evaluate structural organization:

    • The title accurately reflects the content
    • The metadata description is concise, informative, and optimized for SEO
    • The introduction provides a clear overview of the article's purpose
    • Sections are logically organized with proper heading hierarchy
    • Content flows logically without redundancy or repetitive language
    • Relevant next steps or related articles are linked at the end

After your analysis, provide a summary of your findings and actionable feedback for improvement. Group your findings into these categories: "Technical Accuracy," "Style and Grammar," "Structure and Organization," "Accessibility," and "SEO Optimization." For each category, list specific issues identified and suggest concrete improvements with examples.

Repository

microsoft/vscode-docs

Path

.github/skills/review-article/SKILL.md

Last updated
First committed

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.