skills.rest
haryelramalho
haryelramalhoCOMMUNITY
Explore all skills by this author →
Website𝕏@haryel_devGitHub

writing-great-skills

Guide AI skill authors in drafting, reviewing, and refactoring instruction sets with clearer structure and pruning discipline.

Updated May 28, 2026
Search Tags:#documentation#maintainability#skill design#pruning#prompt writing#instruction hierarchy
One-click install
npx skills add https://github.com/haryelramalho/skills --skill writing-great-skills-haryelramalho
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-great-skills
Source: https://github.com/haryelramalho/skills/tree/main/skills/community/writing-great-skills
Command: npx skills add https://github.com/haryelramalho/skills --skill writing-great-skills-haryelramalho

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps authors design and edit AI skills that behave predictably, stay maintainable, and avoid clutter, duplication, and vague instructions.

Core Features & Use Cases

  • Invocation Guidance: Explains when a skill should be model-invoked or user-invoked and how descriptions affect discoverability.
  • Information Hierarchy: Teaches how to separate steps, in-skill reference, and external reference so the most important material stays easy to use.
  • Pruning and Refinement: Shows how to remove no-ops, reduce sprawl, prevent sediment, and keep one single source of truth.
  • Use Case: Use it when you are drafting a new skill, reviewing an existing skill for quality, or refactoring a large skill into a clearer and more reliable form.

Quick Start

Use this skill to review your skill draft and rewrite it so the instructions are clearer, shorter, and more predictable.

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 predictable AI skills with less sprawl?▼

To write predictable AI skills with less sprawl, apply a framework of strict information hierarchy and pruning discipline. This removes no-ops, prevents sediment, and maintains a single source of truth for reliable instruction sets.

What is instruction hierarchy in prompt writing?▼

Instruction hierarchy in prompt writing separates steps, in-skill reference, and external reference. This structure keeps the most important material easy to use and ensures skill content remains reliable and concise during execution.

How do I refactor a large AI skill into a clearer form?▼

Refactor a large AI skill by reviewing it for quality and rewriting instructions to be shorter and clearer. Focus on removing duplicate instructions, reducing sprawl, and strengthening failure mode handling.

When should I use model-invoked versus user-invoked skill descriptions?▼

Skill descriptions determine whether a skill should be model-invoked or user-invoked. Precise description handling affects discoverability and invocation behavior, ensuring the AI triggers the correct instructions at the right time.

What is the best way to maintain AI instruction sets and prevent sediment?▼

The best way to maintain AI instruction sets is through continuous pruning and refinement. Removing no-ops and enforcing one single source of truth prevents sediment and keeps skill content maintainable over time.

Related Skills

Explore More Content & Communication Skills→
fcnatrafcnatra

creating-process-files

Generate and refine process files defining structured AI workflow steps.

Community
Intermediate
idiaz01idiaz01
3

ai-regression-testing

Automate regression testing for AI-assisted development across sandboxed environments.

Community
Advanced
vrcmsvrcms
1

knowledge-ops

Synchronize knowledge across local files, MCP memory, and external repositories.

Community
Advanced
AI-Driven-Highspeed-DevelopmentAI-Driven-Highspeed-Development

writing-prompts

Define and enforce standardized workflows for creating .prompt.md prompt templates.

Official
Intermediate