Back to Skills

tutorial-writing

Technical tutorial writing in modified DigitalOcean style. Use when (1) writing step-by-step technical tutorials, (2) creating documentation for code/applications, (3) explaining technical concepts procedurally, (4) working with Temporal applications/tutorials, or (5) the user asks to write, create, or help with a tutorial. Follows specific style constraints: friendly but formal tone, comprehensive explanations, code sandwich approach, assumes English is reader's second language, and never gener

4starsUpdated 3/3/2026

Security Assessment

Safe(100/100)
Security Score100/100

About tutorial-writing

The 'tutorial-writing' skill is designed to assist in the creation of technical tutorials in a modified DigitalOcean style. This skill is ideal for users who need to write step-by-step instructions for a technical topic, document code or applications, or explain technical concepts in a structured and accessible manner. It ensures a consistent, professional approach while adhering to specific style and content guidelines, such as using a friendly but formal tone and maintaining a clear, comprehensive explanation throughout the tutorial. The skill also emphasizes a 'code sandwich' approach, which is critical for proper code presentation, ensuring code blocks are always contextualized and explained thoroughly.

The main features of this skill include a strict adherence to a defined workflow that emphasizes understanding the code provided and never generating new code. Users are encouraged to follow a clear, logical sequence in presenting technical information, ensuring that tutorials are easy to follow, with clear explanations of both the steps and their underlying reasoning. Target users include technical writers, developers, or anyone who needs to create structured technical documentation, especially in the context of Temporal applications or similar environments. The skill also emphasizes the importance of using provided code only, allowing users to focus on documentation without the need for additional coding expertise.

FAQ

Can I generate new code using this skill?

No, the skill strictly prohibits generating new code. You can only reference the code that has been provided.

What style guide should I follow while writing tutorials?

You must follow the modified DigitalOcean style guide, as outlined in the 'style-guide.md' document.

Is there a specific tone I should use in the tutorials?

Yes, the tone should be friendly but formal, ensuring clarity and accessibility while maintaining professionalism.

Can I create tutorials for Temporal applications?

Yes, this skill is specifically useful for writing tutorials related to Temporal applications, provided you follow the 'temporal-rules.md' document.

What is the 'code sandwich' approach?

The 'code sandwich' approach involves placing explanatory text before and after each code block to ensure it is properly contextualized and explained.

Install tutorial-writing

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill