practice-writer

Generate structured technical training exercises with frontmatter and defined sections.

Updated Dec 14, 2025
One-click install
npx skills add https://github.com/imagepit/text-lint-plugin --skill practice-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: practice-writer
Source: https://github.com/imagepit/text-lint-plugin/tree/main/skills/practice-writer
Command: npx skills add https://github.com/imagepit/text-lint-plugin --skill practice-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines a standard for creating technical training exercises by outlining a consistent frontmatter, chapter structure, and exercise sequence to ensure quality and reusability across courses.

Core Features & Use Cases

  • Establishes a modular framework for building exercises with mandatory frontmatter, a toc placeholder, and sections such as Overview, Problem, Answer Format, and Answer Key to guide learners.
  • Enforces the use of hands-on steps via the :::step directive to describe interactive procedures and supports a tiered difficulty flow (basic, intermediate, advanced).
  • Specifies file-naming conventions (chapter-XX.md) and output layout (dist/exercise) to streamline publishing and versioning of practice chapters.

Quick Start

Create a new chapter file named chapter-01.md with the required frontmatter and three mandatory sections following the prescribed structure.

Frequently Asked Questions about practice-writer

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

FAQPage Schema
How do I create structured practice exercises for technical training?

Create structured practice exercises by using a frontmatter-driven blueprint with mandatory metadata, required sections like Overview and Problem, and a stable chapter-XX.md file-naming scheme to ensure curriculum consistency.

What is the standard format for hands-on training exercises in markdown?

The standard format for hands-on training exercises requires markdown frontmatter, a toc placeholder, and specific sections including Overview, Problem, Answer Format, and Answer Key to guide learners effectively.

How do I add interactive hands-on steps to technical training chapters?

Add interactive hands-on steps to technical training chapters by using the :::step directive to describe procedures, supporting a tiered difficulty flow across basic, intermediate, and advanced levels.

Can I use this exercise creation standard for large curriculum publishing?

Yes, this standard suits large curriculum publishing by enforcing file-naming conventions and an output layout in the dist/exercise directory to streamline versioning and publishing of practice chapters.

What sections are mandatory when building training exercises?

Mandatory sections for building training exercises include Overview, Problem, Answer Format, and Answer Key, alongside required frontmatter metadata containing the title and draft status.