Agent skill
user-guide-writing
Master user guide writing with clear instructions, tutorials, screenshots, and end-user documentation.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/user-guide-writing
SKILL.md
User Guide Writing
Create clear, user-friendly guides that help end-users understand and effectively use your product.
When to Use This Skill
- Onboarding new users
- Feature documentation
- Step-by-step tutorials
- Troubleshooting guides
- FAQ creation
- Release documentation
- Training materials
- Quick start guides
Core Concepts
1. Getting Started Guide
# Getting Started with ProductName
## Create Your Account
1. Go to https://product.com/signup
2. Enter your email address
3. Choose a strong password
4. Click "Create Account"
5. Check your email for verification link
**Tip**: Use a work email for team collaboration features.
## Set Up Your First Project
1. Click "+ New Project" in the dashboard
2. Enter project name and description
3. Choose a template or start blank
4. Click "Create"
**Screenshot**: [Dashboard with New Project button highlighted]
## Invite Your Team
1. Open your project
2. Click "Settings" → "Team"
3. Enter team member emails
4. Select their role (Admin, Member, Viewer)
5. Click "Send Invitations"
**Next Steps**: Learn how to [create tasks](#) and [set up workflows](#).
2. Tutorial Structure
# How to Create a Dashboard
**What you'll learn**: Create custom dashboards to visualize your data.
**Time**: 10 minutes
**Difficulty**: Beginner
## Prerequisites
- Active account
- At least one data source connected
## Steps
### Step 1: Create Dashboard
Navigate to Dashboards and click "+ New Dashboard".
[Screenshot]
### Step 2: Add Widgets
Click "Add Widget" and select chart type:
- Line chart for trends
- Bar chart for comparisons
- Pie chart for distributions
[Screenshot with widget options]
### Step 3: Configure Data
1. Select data source
2. Choose metrics
3. Set time range
4. Apply filters (optional)
[Screenshot of configuration panel]
### Step 4: Customize Appearance
- Change colors in the "Style" tab
- Add title and description
- Adjust chart size
### Step 5: Save and Share
Click "Save" and optionally "Share" to generate public link.
## You Did It!
Your dashboard is ready. Try adding more widgets to create a comprehensive view.
**Related**: [Advanced Dashboard Features](#), [Data Sources Guide](#)
Best Practices
- Task-oriented - Focus on what users want to accomplish
- Clear steps - Numbered, sequential instructions
- Visual aids - Screenshots, diagrams, videos
- Plain language - Avoid technical jargon
- Test instructions - Follow your own steps
- Provide context - Explain why, not just how
- Link related content - Help users discover more
- Keep updated - Maintain accuracy with product changes
Resources
- Style guides: Google Developer Documentation Style Guide
- Screenshot tools: Snagit, CloudApp, Loom for videos
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?