writing-great-skills

Design predictable AI skills with invocation and information hierarchy frameworks.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions --skill writing-great-skills-tgmarinho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-great-skills
Source: https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions/tree/main/upstream-snapshots/mattpocock-skills/skills/productivity/writing-great-skills
Command: npx skills add https://github.com/tgmarinho/agent-super-powers-matt-pocock-skills-comparasions --skill writing-great-skills-tgmarinho

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of creating predictable and effective AI skills by providing a comprehensive framework for skill design and construction.

Core Features & Use Cases

  • Predictability Framework: Offers a set of principles and terms for designing predictable AI skills.
  • Invocation Strategies: Guides on choosing between model-invoked and user-invoked skills based on context.
  • Information Hierarchy: Helps organize skill content for optimal agent interaction.
  • Steering and Pruning: Techniques for shaping agent behavior and maintaining skill relevance.
  • Use Case: When developing a new AI skill, use this framework to ensure it adheres to best practices for predictability and effectiveness.

Quick Start

Review the GLOSSARY.md file to understand the foundational terms 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
What is an AI skill predictability framework and why do I need it?

An AI skill predictability framework provides principles and terms for designing predictable AI skills, ensuring effective agent behavior and maintainability during AI development.

How do I design predictable AI skills for agent interaction?

You design predictable AI skills by applying information hierarchy and invocation strategies, organizing skill content to optimize agent interaction and ensure reliable behavioral shaping during execution.

When should I use model-invoked versus user-invoked AI skills?

Choosing between model-invoked and user-invoked AI skills depends on context, where invocation strategies guide the selection to ensure predictable skill execution based on specific interaction needs.

What techniques shape agent behavior and maintain AI skill relevance?

Steering and pruning techniques shape agent behavior and maintain AI skill relevance by systematically refining skill content and controlling information hierarchy to prevent behavioral drift.

Do I need prior AI engineering experience to use this skill development framework?

This advanced skill development framework assumes prior AI engineering knowledge, providing comprehensive design principles rather than introductory tutorials for building predictable AI skills.

What are the limitations of using behavioral shaping for AI skill development?

Behavioral shaping limitations in AI skill development arise when complex context overrides steering techniques, requiring continuous pruning of information hierarchy to maintain skill predictability and relevance.