skills.rest
christopher-buss
christopher-bussCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-great-skills

Provides guidance for writing and organizing effective skill content.

6|Updated Nov 30, 2025
Search Tags:#AI development#skill structure#predictability#AI maintainability#AI skill writing
One-click install
npx skills add https://github.com/christopher-buss/bedrock --skill writing-great-skills-christopher-buss
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-great-skills
Source: https://github.com/christopher-buss/bedrock/tree/main/.agents/skills/writing-great-skills
Command: npx skills add https://github.com/christopher-buss/bedrock --skill writing-great-skills-christopher-buss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenges of writing and editing skills well by providing a comprehensive guide to the vocabulary, principles, and best practices for predictability and maintainability.

Core Features & Use Cases

  • Predictability Guide: Offers detailed explanations and examples of how to create skills that produce consistent results every time.
  • Model Invocation: Discusses the benefits and considerations of model-invoked versus user-invoked skills, including context load and cognitive load.
  • Information Hierarchy: Provides strategies for structuring skills for clarity and ease of use, including steps, reference, and progressive disclosure.
  • Splitting and Pruning: Outlines when and how to split skills and prune outdated content to maintain relevance and efficiency.
  • Leading Words: Offers guidance on using leading words effectively to improve skill invocation and maintain predictability.

Quick Start

Review the GLOSSARY.md to understand the core concepts and principles of writing great skills.

Frequently Asked Questions about writing-great-skills

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

FAQPage Schema
How do I write AI skills that produce predictable and consistent results?▼

Writing predictable AI skills requires a clear content hierarchy, progressive disclosure, and consistent leading words. This structure minimizes ambiguity and ensures the model processes instructions uniformly across multiple invocations.

What is the best way to structure an AI skill for maintainability?▼

Structuring an AI skill for maintainability requires organizing content into clear steps and references, applying progressive disclosure, and pruning outdated content. This separation keeps the skill lightweight and easy to update over time.

When should I split an AI skill or prune outdated content?▼

You should split an AI skill when its scope exceeds logical boundaries or prune content when it becomes outdated. This manages context load, maintains relevance, and preserves the skill's operational predictability and efficiency.

How do leading words affect AI skill invocation and predictability?▼

Leading words act as triggers that guide model invocation and improve predictability. Using them effectively ensures the skill activates in the correct context, reducing misfires and maintaining consistent behavioral outputs.

What is the difference between model-invoked and user-invoked AI skills?▼

Model-invoked skills are triggered automatically by the AI based on context, while user-invoked skills require explicit activation. Choosing between them affects context load and cognitive load, impacting overall system predictability.

Related Skills

Explore More Software Engineering Skills→
kevinnftkevinnft
13

ubiquitous-language

Extract domain terminology from conversations into a structured glossary file.

Community
Intermediate
hiddink-aihiddink-ai
1

optimize-bundle

Analyze build output and apply code splitting and tree-shaking optimizations.

Official
Intermediate
HarshodaiHarshodai

impeccable

Design and iterate frontend interfaces with UX, accessibility, and visual hierarchy standards.

Community
Advanced
tgmarinhotgmarinho

writing-great-skills

Design predictable AI skills with invocation and information hierarchy frameworks.

Community
Advanced