CtrlK
BlogDocsLog inGet started
Tessl Logo

support-docs

When the user needs to create help center articles, FAQs, troubleshooting guides, API documentation, or getting-started guides for customers.

71

Quality

64%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/support-docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

64%

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 has good trigger term coverage with natural keywords users would use when requesting help center content. However, it lacks specificity about what the skill actually does beyond 'create'—it doesn't describe concrete actions, formatting capabilities, or output characteristics. The description reads more as a 'when to use' clause without a corresponding 'what it does' clause.

Suggestions

Add concrete actions describing what the skill does, e.g., 'Creates structured help center articles with clear headings, step-by-step instructions, and consistent formatting' before the trigger clause.

Differentiate from general writing or documentation skills by specifying unique capabilities like tone guidelines, template structures, or customer-facing language standards.

DimensionReasoningScore

Specificity

The description names the domain (help center content) and lists several content types (articles, FAQs, troubleshooting guides, API documentation, getting-started guides), but it doesn't describe concrete actions—it only says 'create' without detailing specific capabilities like formatting, structuring, or publishing.

2 / 3

Completeness

The description answers 'when' clearly ('When the user needs to create...') but the 'what does this do' part is weak—it only implies creation without describing the skill's specific capabilities, approach, or output format. The 'what' is essentially just a list of content types rather than a description of the skill's functionality.

2 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'help center articles', 'FAQs', 'troubleshooting guides', 'API documentation', 'getting-started guides', and 'customers'. These are terms users would naturally use when requesting this type of content.

3 / 3

Distinctiveness Conflict Risk

While it carves out a niche around help center and customer-facing documentation, it could overlap with general writing skills, documentation skills, or technical writing skills. The mention of 'API documentation' in particular could conflict with developer documentation skills.

2 / 3

Total

9

/

12

Passed

Implementation

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured and highly actionable skill with excellent concrete templates and real-world examples that Claude can directly apply. Its main weaknesses are verbosity (some sections explain concepts Claude already knows, and the monolithic structure could benefit from splitting into referenced files) and the lack of explicit validation checkpoints in the workflow for what is essentially a content creation process that impacts customer experience.

Suggestions

Extract the five templates and the Frameworks & Best Practices section into separate referenced files (e.g., TEMPLATES.md, BEST-PRACTICES.md) to keep SKILL.md as a lean overview with clear navigation links.

Add an explicit validation/review step in the workflow, such as checking the output against the '3 AM rule' criteria as a concrete checklist rather than a vague heuristic, and verifying all UI paths and error messages are current.

Remove writing advice Claude already knows (second person, present tense, show-then-explain) or condense it to a brief bullet list of project-specific conventions only.

DimensionReasoningScore

Conciseness

The skill is fairly comprehensive but includes some unnecessary explanation that Claude would already know (e.g., explaining what progressive disclosure means, the general concept of problem-solution format). The writing style section includes basic writing advice ('Second person, present tense') that Claude inherently understands. However, the templates and frameworks do add genuine value and aren't purely redundant.

2 / 3

Actionability

The skill provides five concrete, copy-paste-ready templates with specific structural elements, exact formatting patterns, and real examples including a detailed troubleshooting guide excerpt with actual error messages. The API documentation template specifies exact components (curl examples, parameter tables, error codes). The guidance is highly specific and executable.

3 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced and logical, but lacks explicit validation checkpoints. Step 6 ('3 AM rule') is a soft validation heuristic rather than a concrete verification step. There's no feedback loop for reviewing output quality against support ticket data or user testing before publishing. For documentation that could mislead users, a more explicit review/validation step would be warranted.

2 / 3

Progressive Disclosure

The skill references related skills at the bottom and organizes content into logical sections (workflow, templates, frameworks, examples). However, the content is quite long (~150+ lines) and inlines substantial detail (all five templates, full frameworks, writing style guides, and maintenance advice) that could be split into referenced files. The templates and best practices sections could each be separate documents linked from a leaner overview.

2 / 3

Total

9

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
shawnpang/startup-founder-skills
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.