creating-tutorial

Scaffold bilingual tutorials with frontmatter and astro.config.mjs registration.

Updated Sep 26, 2025
One-click install
npx skills add https://github.com/innFactory-AI/docs --skill creating-tutorial
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-tutorial
Source: https://github.com/innFactory-AI/docs/tree/main/.claude/skills/creating-tutorial
Command: npx skills add https://github.com/innFactory-AI/docs --skill creating-tutorial

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authors often struggle to produce consistent, bilingual tutorials with proper frontmatter and publication-ready structure across a multilingual docs site.

Core Features & Use Cases

  • Frontmatter-driven scaffolding ensures each tutorial has the required metadata and translations.
  • Two tutorial shapes (How-To guides and Agent templates) with English/German mirrors, tutorials index entries, and astro.config.mjs registrations.
  • Automated boilerplate that streamlines creation, validation, and publication workflow for tutorials.

Quick Start

Create a bilingual How-To/tutorial scaffold under src/content/docs/de/tutorials and en/tutorials, including frontmatter, structure, screenshots, index links, and astro.config.mjs registration.

Frequently Asked Questions about creating-tutorial

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create bilingual tutorials with consistent frontmatter for a docs site?

Scaffolding bilingual tutorials with consistent frontmatter generates required metadata fields and English/German translations simultaneously. This ensures publication-ready structure across your multilingual docs site without manual formatting errors.

What frontmatter fields are required to publish tutorials in Astro?

Required frontmatter fields for publishing tutorials include bilingual metadata for English/German mirrors and astro.config.mjs registration entries. Specifying these organizational conventions validates structure and ensures tutorials appear correctly in site indexes.

Can I use this to scaffold both how-to guides and agent templates?

Yes, scaffolding applies to both tutorial shapes: how-to guides and agent templates. Each shape receives English/German mirrors, tutorials index entries, and astro.config.mjs registration to maintain consistent bilingual documentation.

What's the best way to structure bilingual documentation for English and German audiences?

The best way to structure bilingual documentation is generating English/German mirrors under src/content/docs/de/tutorials and en/tutorials. Automated boilerplate creates matching frontmatter, index links, and screenshots for consistent multilingual publishing.

Do I need to manually update astro.config.mjs when adding new tutorials?

No, astro.config.mjs registration is handled automatically during scaffolding. Creating a bilingual tutorial scaffold includes registering the new entry in astro.config.mjs, ensuring the docs site recognizes both how-to guides and agent templates.

Why does my bilingual tutorial structure fail validation on the docs site?

Bilingual tutorial structure fails validation when required frontmatter fields are missing or English/German mirrors are misaligned. Applying consistent frontmatter scaffolding with index entries and astro.config.mjs registration ensures tutorials pass structural validation.