Skip to content
cccskills
FreePublished on GitHub

writing-great-skills

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

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (3)

  • SKILL.md1.6 KB
  • agents/openai.yaml149 B
  • GLOSSARY.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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 when shared vocabulary helps discuss invocation, information hierarchy, steering, or pruning.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Create or review an AGENTS.md file so coding agents get stable repo-local instructions: environment setup, testing, style, security boundaries, PR policy, and handoff rules. Use when a repo lacks durable agent guidance or when a custom harness needs a predictable context file.

The English summary is being prepared. Showing the original description.

stevesolun/ctx589Updated Oct 15, 2026

Recommend the smallest Matt Pocock skill or short skill sequence that fits the user's current goal.

The English summary is being prepared. Showing the original description.

stevesolun/ctx589Updated Oct 15, 2026

Decision guide for delegating to caveman-style subagents. Tells the main thread WHEN to spawn `cavecrew-investigator` (locate code), `cavecrew-builder` (1-2 file edit), or `cavecrew-reviewer` (diff review) instead of doing the work inline or using vanilla `Explore`. Subagent output is caveman-compressed so the tool-result injected back into main context is ~60% smaller — main context lasts longer across long sessions. Trigger: "delegate to subagent", "use cavecrew", "spawn investigator/builder/reviewer", "save context", "compressed agent output".

The English summary is being prepared. Showing the original description.

stevesolun/ctx589Updated Oct 15, 2026

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

The English summary is being prepared. Showing the original description.

stevesolun/ctx589Updated Oct 15, 2026

Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra, wenyan-lite, wenyan-full, wenyan-ultra. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.

The English summary is being prepared. Showing the original description.

stevesolun/ctx589Updated Oct 15, 2026

Ultra-compressed commit message generator. Cuts noise from commit messages while preserving intent and reasoning. Conventional Commits format. Subject ≤50 chars, body only when "why" isn't obvious. Use when user says "write a commit", "commit message", "generate commit", "/commit", or invokes /caveman-commit. Auto-triggers when staging changes.

The English summary is being prepared. Showing the original description.

stevesolun/ctx589Updated Oct 15, 2026

See all skills by stevesolun

Report a problem with this skill