Skip to content

stevesolun/ctx / .agents/skills/writing-great-skills

writing-great-skills

Verified

Design or revise concise skills with clear triggers, proportional constraints, progressive disclosure, and realistic validation.

FileKindSize
GLOSSARY.mdmarkdown1.9 KB
SKILL.mdskill md1.6 KB
agents/openai.yamlconfig149 B
---
name: writing-great-skills
description: Design or revise concise skills with clear triggers, proportional constraints, progressive disclosure, and realistic validation.
---

# Write an effective skill

1. Define the job, realistic trigger prompts, non-trigger prompts, expected
   output, and material failure modes.
2. Choose the degree of freedom:
   - Use judgment-based guidance when context admits several good approaches.
   - Use parameters or pseudocode when a preferred pattern still needs
     adaptation.
   - Use deterministic scripts or hard gates only when reliability, safety, or
     repeatability justifies the constraint.
3. Keep metadata concise and discriminative. Put trigger conditions in the
   description; put execution guidance in the body.
4. Assume the model already understands general software work. Preserve only
   domain knowledge, workflow choices, tool interfaces, and opinions that
   materially change behavior.
5. Keep the entrypoint legible. Move branch-specific detail, catalogues,
   templates, and examples to direct references; avoid deep reference chains.
6. Prefer positive target behavior and surrounding-context judgment over
   blanket prohibitions. State exact constraints where mistakes would be
   costly or hard to recover.
7. Validate syntax and links, then test both triggering and output quality with
   fresh, realistic prompts. Compare against a no-skill baseline when the
   skill's value is uncertain.
8. Prune repetition, stale material, and instructions that do not change model
   behavior.

Read [GLOSSARY.md](GLOSSARY.md) when shared vocabulary helps discuss invocation,
information hierarchy, steering, or pruning.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall