How do I install the Writing Tutorials skill?

Run npx skillmds@latest add gabrielmoreira/writing-tutorials in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Writing Tutorials skill do?

Writing Medusa Tutorials It is listed under Coding & Dev Tools on SkillMD.

Is Writing Tutorials safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Writing Tutorials?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Writing Tutorials free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Writing Tutorials?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Writing Tutorials by gabrielmoreira

Name: Writing Tutorials
Rating: 4.5 (4 reviews)
Author: gabrielmoreira

File contents

Writing Medusa Tutorials

Guides an agent through creating a complete Medusa tutorial: building the feature in an example project, then writing the documentation.

Two-Phase Approach

Phase 1 — Build: Gather requirements → plan with user → implement feature → add tests → confirm with user Phase 2 — Write: Create step diagram → write per-step MD files → combine into final MDX → update sidebar → clean up

CRITICAL: Never do both phases in one session. Complete Phase 1, get user confirmation, then reload this skill for Phase 2.

Load Reference Files When Needed

Load at least one reference file before proceeding.

Task	Load
Starting Phase 1 (building)	`reference/building-phase.md`
Starting Phase 2 (writing)	`reference/writing-phase.md` + `reference/tutorial-conventions.md` + `reference/concept-definitions.md`
MDX patterns and components	`reference/tutorial-conventions.md`
Concept definitions (module, workflow, etc.)	`reference/concept-definitions.md`

Quick Reference

File Locations

Type	Content Path	Sidebar File
How-to tutorial	`www/apps/resources/app/how-to-tutorials/tutorials/{name}/page.mdx`	`www/apps/resources/sidebars/how-to-tutorials.mjs`
Integration guide	`www/apps/resources/app/integrations/guides/{name}/page.mdx`	`www/apps/resources/sidebars/integrations.mjs`

Development Skills to Load During Build

Backend features → medusa-dev:building-with-medusa
Admin UI → medusa-dev:building-admin-dashboard-customizations
Storefront → medusa-dev:building-storefronts
Third-party services → context7 MCP or skills
Medusa API questions → mcp__medusa__ask_medusa_question

Common Mistakes

Jumping straight to writing documentation without building the feature first
Writing both phases in one session without user confirmation between them
Writing Step 1 (Medusa installation) from scratch — use the pre-written template in tutorial-conventions.md
Forgetting to update the sidebar after writing the tutorial MDX
Leaving _step-*.md temp files after combining into final MDX
Making tutorial code overly complex — tutorials are educational, keep it simple

---name: writing-tutorialsdescription: Writing Medusa Tutorials---# Writing Medusa TutorialsGuides an agent through creating a complete Medusa tutorial: building the feature in an example project, then writing the documentation.## Two-Phase Approach**Phase 1 — Build:** Gather requirements → plan with user → implement feature → add tests → confirm with user**Phase 2 — Write:** Create step diagram → write per-step MD files → combine into final MDX → update sidebar → clean up> **CRITICAL:** Never do both phases in one session. Complete Phase 1, get user confirmation, then reload this skill for Phase 2.## Load Reference Files When Needed> **Load at least one reference file before proceeding.**| Task | Load ||------|------|| Starting Phase 1 (building) | `reference/building-phase.md` || Starting Phase 2 (writing) | `reference/writing-phase.md` + `reference/tutorial-conventions.md` + `reference/concept-definitions.md` || MDX patterns and components | `reference/tutorial-conventions.md` || Concept definitions (module, workflow, etc.) | `reference/concept-definitions.md` |## Quick Reference### File Locations| Type | Content Path | Sidebar File ||------|-------------|--------------|| How-to tutorial | `www/apps/resources/app/how-to-tutorials/tutorials/{name}/page.mdx` | `www/apps/resources/sidebars/how-to-tutorials.mjs` || Integration guide | `www/apps/resources/app/integrations/guides/{name}/page.mdx` | `www/apps/resources/sidebars/integrations.mjs` |### Development Skills to Load During Build- Backend features → `medusa-dev:building-with-medusa`- Admin UI → `medusa-dev:building-admin-dashboard-customizations`- Storefront → `medusa-dev:building-storefronts`- Third-party services → `context7` MCP or skills- Medusa API questions → `mcp__medusa__ask_medusa_question`## Common Mistakes- [ ] Jumping straight to writing documentation without building the feature first- [ ] Writing both phases in one session without user confirmation between them- [ ] Writing Step 1 (Medusa installation) from scratch — use the pre-written template in `tutorial-conventions.md`- [ ] Forgetting to update the sidebar after writing the tutorial MDX- [ ] Leaving `_step-*.md` temp files after combining into final MDX- [ ] Making tutorial code overly complex — tutorials are educational, keep it simple

Frequently asked questions

Writing Tutorials