crafting-instructions

Solid

Chooses the right FORMAT for instructions on Claude.ai — project instructions, a skill, or a standalone prompt — and gives the format-specific structure once chosen. Use when the question is which container an instruction belongs in ("should this be a skill or project instructions", "where do I put this", "how do I set up this project", "is this worth a skill"), or when someone has instructions and does not know how to package them. For the writing principles that apply inside any of the three formats, use writing-instructions. For building, testing and packaging a complete skill directory, use creating-skill.

Testing & QA 148 stars 5 forks Updated today MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
72
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Crafting Instructions for Claude Choose the format for instructions on Claude.ai — Project instructions, Skills, or standalone prompts — and structure them for the format chosen. **Overlap notice.** The Core Optimization Principles below also appear in `writing-instructions`, which carries them in more depth. This skill owns the **format decision**; `writing-instructions` owns **how to write well inside a format**. The two descriptions are close enough that a request can land on either — route by which of those two questions is being asked. ## Decision Framework: Which Format to Use? Ask these questions to determine the right format: ### Use PROJECT INSTRUCTIONS when: - Context needs to persist for ALL conversations in a workspace - Multiple team members collaborate with shared knowledge - Background knowledge required for specific initiative - Custom behavior scoped to one project only **Signals:** "for this project", "all conversations about X", "team workspace", "project-specific" ### Use SKILL when: - Capability needed across MULTIPLE contexts/projects - Procedural knowledge that applies broadly - Instructions should activate automatically when relevant - Want portable expertise that loads on-demand **Signals:** "every time I", "whenever", "reusable", "across projects", "teach Claude how to" ### Use STANDALONE PROMPT when: - One-off request with immediate context - Ad-hoc instructions for single use - Conversational refinement - No need for persistence **Signa...

Details

Author
oaustegard
Repository
oaustegard/claude-skills
Created
10 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

writing-agent-instructions

Use when creating or revising an agent skill, AGENTS.md, CLAUDE.md, or nested project instructions, including trigger design, progressive disclosure, harness-aware scope, and behavioral validation.

5 Updated 2 days ago
lawzava
AI & Automation Solid

skill-creation-walkthrough

Step-by-step guide for creating your own Claude Skills, from deciding whether a skill is the right tool to writing the SKILL.md file, structuring reference material, and making it trigger reliably. Use when you want to package a workflow, framework, or repeated task into a reusable Skill, when an existing skill is not triggering or not loading the right context, when you are auditing a skill that is underperforming, or when you want to publish a skill for others. Also triggers when someone asks "how do I make a skill" or "what makes a good skill". Useful for individuals, teams, and anyone publishing skills publicly.

4 Updated 1 months ago
rampstackco
AI & Automation Listed

skill-creation-walkthrough

Step-by-step guide for creating your own Claude Skills, from deciding whether a skill is the right tool to writing the SKILL.md file, structuring reference material, and making it trigger reliably. Use when you want to package a workflow, framework, or repeated task into a reusable Skill, when an existing skill is not triggering or not loading the right context, when you are auditing a skill that is underperforming, or when you want to publish a skill for others. Also triggers when someone asks "how do I make a skill" or "what makes a good skill". Useful for individuals, teams, and anyone publishing skills publicly.

2 Updated 1 months ago
rampstackco