Skip to content

aiskillstore/marketplace / skills/2025emma/claude-skills

claude-skills

Verified

Claude Skills meta-skill: extract domain material (docs/APIs/code/specs) into a reusable Skill (SKILL.md + references/scripts/assets), and refactor existing Skills for clarity, activation reliability, and quality gates.

FileKindSize
AGENTS.mdmarkdown1.9 KB
SKILL.mdskill md7.9 KB
assets/template-complete.mdmarkdown2.4 KB
assets/template-minimal.mdmarkdown926 B
references/README.mdmarkdown7.5 KB
references/anti-patterns.mdmarkdown3.0 KB
references/index.mdmarkdown1.3 KB
references/quality-checklist.mdmarkdown1.9 KB
references/skill-spec.mdmarkdown3.4 KB
scripts/create-skill.shscript4.1 KB
scripts/validate-skill.shscript5.4 KB
skill-report.jsonconfig35.2 KB

scripts/create-skill.sh

View on GitHub
TRANSLATED CONTENT:
#!/usr/bin/env bash

set -euo pipefail

# ==================== Help ====================

usage() {
  cat <<'EOF'
Usage:
  create-skill.sh <skill-name> [--minimal|--full] [--output <dir>] [--force]

Notes:
  - <skill-name> MUST be lowercase, start with a letter, and only contain letters, digits, and hyphens
  - Default mode: --full
  - Default output: current directory (creates ./<skill-name>/)

Examples:
  ./skills/claude-skills/scripts/create-skill.sh postgresql --full --output skills
  ./skills/claude-skills/scripts/create-skill.sh my-api --minimal
EOF
}

die() {
  echo "Error: $*" >&2
  exit 1
}

# ==================== Arg Parsing ====================

skill_name=""
mode="full"
output_dir="."
force=0

while [[ $# -gt 0 ]]; do
  case "$1" in
    -h|--help)
      usage
      exit 0
      ;;
    --minimal)
      mode="minimal"
      shift
      ;;
    --full)
      mode="full"
      shift
      ;;
    -o|--output)
      [[ $# -ge 2 ]] || die "--output requires a directory argument"
      output_dir="$2"
      shift 2
      ;;
    -f|--force)
      force=1
      shift
      ;;
    --)
      shift
      break
      ;;
    -*)
      die "Unknown argument: $1 (use --help)"
      ;;
    *)
      if [[ -z "$skill_name" ]]; then
        skill_name="$1"
        shift
      else
        die "Extra argument: $1 (only one <skill-name> is allowed)"
      fi
      ;;
  esac
done

[[ -n "$skill_name" ]] || { usage; exit 1; }

if [[ ! "$skill_name" =~ ^[a-z][a-z0-9-]*$ ]]; then
  die "skill-name must be lowercase, start with a letter, and only contain letters/digits/hyphens (e.g. my-skill-name)"
fi

script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
assets_dir="${script_dir}/../assets"

template_path=""
case "$mode" in
  minimal) template_path="${assets_dir}/template-minimal.md" ;;
  full) template_path="${assets_dir}/template-complete.md" ;;
  *) die "Internal error: unknown mode=$mode" ;;
esac

[[ -f "$template_path" ]] || die "Template not found: $template_path"

mkdir -p "$output_dir"

target_dir="${output_dir%/}/${skill_name}"

if [[ -e "$target_dir" && "$force" -ne 1 ]]; then
  die "Target already exists: $target_dir (use --force to overwrite)"
fi

mkdir -p "$target_dir"/{assets,scripts,references}

# ==================== Write Files ====================

render_template() {
  local src="$1"
  local dest="$2"
  sed "s/{{skill_name}}/${skill_name}/g" "$src" > "$dest"
}

render_template "$template_path" "$target_dir/SKILL.md"

cat > "$target_dir/references/index.md" <<EOF
# ${skill_name} Reference Index

## Quick Links

- Getting started: \`getting_started.md\`
- API/CLI/config: \`api.md\` (if applicable)
- Examples: \`examples.md\`
- Troubleshooting: \`troubleshooting.md\`

## Notes

- Put long-form content here: excerpts, evidence links, edge cases, FAQ
- Keep \`SKILL.md\` Quick Reference short and directly usable
EOF

if [[ "$mode" == "full" ]]; then
  cat > "$target_dir/references/getting_started.md" <<'EOF'
# Getting Started & Vocabulary

## Goals

- Define the 10 most important terms in this domain
- Provide the shortest path from zero to working
EOF

  cat > "$target_dir/references/api.md" <<'EOF'
# API / CLI / Config Reference (If Applicable)

## Suggested Structure

- Organize by use case, not alphabetically
- Key parameters: defaults, boundaries, common misuse
- Common errors: message -> cause -> fix steps
EOF

  cat > "$target_dir/references/examples.md" <<'EOF'
# Long Examples

Put examples longer than ~20 lines here, split by use case:

- Use case 1: ...
- Use case 2: ...
EOF

  cat > "$target_dir/references/troubleshooting.md" <<'EOF'
# Troubleshooting & Edge Cases

Write as: symptom -> likely causes -> diagnosis -> fix.
EOF
fi

# ==================== Summary ====================

echo ""
echo "OK: Skill generated: $target_dir/"
echo ""
echo "Layout:"
echo "  $target_dir/"
echo "  |-- SKILL.md"
echo "  |-- assets/"
echo "  |-- scripts/"
echo "  \\-- references/"
echo "      \\-- index.md"
echo ""
echo "Next steps:"
echo "  1) Edit $target_dir/SKILL.md (triggers/boundaries/quick reference/examples)"
echo "  2) Put long-form docs into $target_dir/references/ and update index.md"
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall