user-guide-writing

Write clear and helpful user guides and tutorials for end users. Use when creating onboarding docs, how-to guides, or FAQ pages. Handles user-focused documentation, screenshots, step-by-step instructions.

Install with Tessl CLI

npx tessl i github:supercent-io/skills-template --skill user-guide-writing

What are skills?

1.15x

Quality

78%

Does it follow best practices?

Impact

97%

1.15x

Average score across 3 eval scenarios

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agent-skills/user-guide-writing/SKILL.md

SKILL.md

Review

Evals

Evaluation results

100%

17%

Documentation Launch: Getting Started Guide for TaskFlow

Quick start guide structure and directory layout

Criteria

Without context

With context

docs/ root directory

100%

getting-started.md file

66%

100%

images/ subfolder

100%

Account creation steps

100%

Password requirements documented

70%

100%

Profile completion section

100%

First project/workspace section

100%

Next Steps section

25%

100%

Need Help section

25%

100%

Screenshot references

100%

Numbered step format

100%

No technical jargon

100%

Short paragraphs

100%

Without context: $0.3260 · 1m 28s · 20 turns · 27 in / 4,669 out tokens

With context: $0.5966 · 2m 16s · 26 turns · 32 in / 7,548 out tokens

100%

10%

Help Article: Connecting a Third-Party Calendar to SchedulePro

How-to guide structure with troubleshooting

Criteria

Without context

With context

Before You Start section

100%

Numbered step-by-step

100%

Screenshot references

100%

Troubleshooting section

100%

Bold Problem format

100%

Multiple troubleshooting items

100%

Related Guides section

100%

No technical jargon

100%

Short paragraphs

100%

User-centric language

100%

GIF or multi-media reference

100%

Without context: $0.1722 · 58s · 12 turns · 18 in / 3,097 out tokens

With context: $0.3489 · 1m 15s · 18 turns · 325 in / 3,741 out tokens

93%

12%

Help Center Launch: Tutorial and FAQ for BudgetWise

Tutorial and FAQ page structure

Criteria

Without context

With context

Tutorial time metadata

66%

100%

Tutorial difficulty metadata

100%

Tutorial prerequisites metadata

50%

66%

What You'll Build section

37%

100%

Tutorial screenshot reference

100%

Tutorial numbered steps

100%

Tutorial Next Steps section

25%

100%

Congratulations closing

100%

50%

FAQ thematic sections

100%

FAQ H3 question headers

100%

Still Have Questions section

100%

Multiple support channels in FAQ

100%

No technical jargon

70%

90%

Without context: $0.3288 · 1m 40s · 18 turns · 24 in / 5,447 out tokens

With context: $0.4348 · 1m 40s · 20 turns · 27 in / 5,181 out tokens

Evaluated: 3 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Documentation Launch: Getting Started Guide for TaskFlow Help Article: Connecting a Third-Party Calendar to SchedulePro Help Center Launch: Tutorial and FAQ for BudgetWise

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.