Content Writer Skills Guide

Guide educational content creation optimized for Retrieval Augmented Generation systems.

Updated Dec 8, 2025
One-click install
npx skills add https://github.com/marjan-ahmed/humanoid-robotics-textbook --skill content-writer-skills-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Content Writer Skills Guide
Source: https://github.com/marjan-ahmed/humanoid-robotics-textbook/tree/main/.claude/skills/content-writer
Command: npx skills add https://github.com/marjan-ahmed/humanoid-robotics-textbook --skill content-writer-skills-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to writing educational content optimized for Retrieval Augmented Generation (RAG) systems, ensuring clarity, discoverability, and effective learning for students.

Core Features & Use Cases

  • RAG Optimization: Learn principles like atomic concept structure, hierarchical architecture, and semantic richness to make content easily retrievable by AI.
  • Educational Clarity: Master techniques for progressive complexity, concrete examples, and addressing common misconceptions.
  • Use Case: A technical writer needs to create documentation for a new robotics API. They can use this guide to structure their content so that both AI assistants and human learners can easily understand and retrieve specific information about each function, parameter, and example.

Quick Start

Follow the guidelines in this document to structure and write your next piece of educational content for optimal RAG performance.

Frequently Asked Questions about Content Writer Skills Guide

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

FAQPage Schema
How do I write technical documentation optimized for RAG systems?

To write technical documentation optimized for RAG systems, structure content atomically, use hierarchical organization, and ensure semantic richness so AI can easily retrieve specific educational information.

What is atomic concept structure in educational content writing?

Atomic concept structure in educational content writing involves breaking down technical topics into self-contained, standalone units, allowing AI assistants and human learners to retrieve specific information without needing surrounding context.

How do I format technical writing for AI retrieval and human learners?

Format technical writing for AI retrieval and human learners by applying progressive complexity, providing concrete examples, addressing common misconceptions, and using RAG-specific formatting to maximize educational clarity.

Can I use this content writing guide for robotics API documentation?

Yes, you can use this content writing guide for robotics API documentation. It specifically addresses structuring technical content so both AI assistants and human learners can understand functions, parameters, and examples.

What's the best way to structure educational content for AI optimization?

The best way to structure educational content for AI optimization is to combine hierarchical architecture with semantic richness, ensuring progressive complexity and concrete examples that address common misconceptions for effective RAG performance.

Why does my documentation fail to retrieve properly in RAG applications?

Documentation fails to retrieve properly in RAG applications when it lacks atomic structure, hierarchical organization, and semantic richness, preventing the AI from effectively isolating and understanding specific educational concepts.