tim-hub/powerball-harness / .claude/skills/release-this
release-this
VerifiedOrchestrates the full powerball-harness plugin release with build, validation, version bump, CHANGELOG, tag, and GitHub Release. Use when releasing this plugin.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.9 KB |
| references/versioning-rules.md | markdown | 2.5 KB |
| references/writing-changelog.md | markdown | 2.9 KB |
| scripts/bench-residue.shexecutable | script | 1.2 KB |
| scripts/check-consistency.shexecutable | script | 19.7 KB |
| scripts/check-residue.py | script | 16.2 KB |
| scripts/release-preflight.shexecutable | script | 12.2 KB |
| scripts/sync-version.shexecutable | script | 6.6 KB |
| scripts/validate-release-notes.shexecutable | script | 2.4 KB |
scripts/check-consistency.sh
View on GitHub#!/bin/bash
# check-consistency.sh
# Plugin consistency check
#
# Usage: bash .claude/skills/release-this/scripts/check-consistency.sh
# Exit codes:
# 0 - All checks passed
# 1 - Inconsistencies found
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" # skill-local: this script's directory
PROJECT_ROOT="$(git rev-parse --show-toplevel)" # project-root: user's git repository root
PLUGIN_ROOT="$PROJECT_ROOT"
HARNESS_ROOT="$PLUGIN_ROOT/harness"
ERRORS=0
echo "π claude-code-harness consistency check"
echo "ββββββββββββββββββββββββββββββββββββββββ"
# ================================
# 1. Template file existence check
# ================================
echo ""
echo "π [1/13] Checking template file existence..."
REQUIRED_TEMPLATES=(
"harness/templates/AGENTS.md.template"
"harness/templates/CLAUDE.md.template"
"harness/templates/Plans.md.template"
"harness/templates/.claude-code-harness-version.template"
"harness/templates/.claude-code-harness.config.yaml.template"
"harness/templates/claude/settings.security.json.template"
"harness/templates/claude/settings.local.json.template"
"harness/templates/rules/workflow.md.template"
"harness/templates/rules/coding-standards.md.template"
"harness/templates/rules/plans-management.md.template"
"harness/templates/rules/testing.md.template"
"harness/templates/rules/ui-debugging-agent-browser.md.template"
)
for template in "${REQUIRED_TEMPLATES[@]}"; do
if [ ! -f "$PLUGIN_ROOT/$template" ]; then
echo " β Missing: $template"
ERRORS=$((ERRORS + 1))
else
echo " β
$template"
fi
done
# ================================
# 2. Command β Skill consistency
# ================================
echo ""
echo "π [2/13] Command β Skill reference consistency..."
# Check if templates referenced by commands exist
check_command_references() {
local cmd_file="$1"
local cmd_name=$(basename "$cmd_file" .md)
# Extract references to templates (handle both old templates/ and new harness/templates/)
local refs=$(grep -oE '(harness/)?templates/[a-zA-Z0-9/_.-]+' "$cmd_file" 2>/dev/null || true)
for ref in $refs; do
# Normalize: add harness/ prefix if missing
[[ "$ref" != harness/* ]] && ref="harness/$ref"
if [ ! -e "$PLUGIN_ROOT/$ref" ] && [ ! -e "$PLUGIN_ROOT/${ref}.template" ]; then
echo " β $cmd_name: Referenced path does not exist: $ref"
ERRORS=$((ERRORS + 1))
fi
done
}
if [ -d "$PLUGIN_ROOT/commands" ]; then
for cmd in "$PLUGIN_ROOT/commands"/*.md; do
check_command_references "$cmd"
done
echo " β
Command reference check complete"
else
echo " β
Command reference check skipped (commands/ removed β migrated to skills)"
fi
# ================================
# 3. Version number consistency
# Checks: VERSION == harness.toml
# Not checked: marketplace.json (version field removed v4.4.0+)
# template _harness_version (backward-compatible, intentionally skipped)
# ================================
echo ""
echo "π·οΈ [3/13] Version number consistency..."
VERSION_FILE="$HARNESS_ROOT/VERSION"
HARNESS_TOML="$HARNESS_ROOT/harness.toml"
if [ -f "$VERSION_FILE" ]; then
FILE_VERSION=$(cat "$VERSION_FILE" | tr -d '[:space:]')
if [ -f "$HARNESS_TOML" ]; then
TOML_VERSION=$(grep '^version' "$HARNESS_TOML" | head -1 | sed 's/.*= "\([^"]*\)".*/\1/' || true)
if [ "$FILE_VERSION" != "$TOML_VERSION" ]; then
echo " β Version mismatch: VERSION=$FILE_VERSION, harness.toml=$TOML_VERSION"
ERRORS=$((ERRORS + 1))
else
echo " β
VERSION and harness.toml match: $FILE_VERSION"
fi
else
echo " β
VERSION: $FILE_VERSION (harness.toml not found, skipped)"
fi
fi
LATEST_RELEASE_URL="https://github.com/tim-hub/powerball-harness/releases/latest"
LATEST_RELEASE_BADGE="https://img.shields.io/github/v/release/tim-hub/powerball-harness?display_name=tag&sort=semver"
# ================================
# 4. Expected skill file structure
# ================================
echo ""
echo "π [4/13] Expected skill definition file structure..."
# 2agent config is integrated into harness-setup
# Check for existence of skills/harness-setup/SKILL.md
SETUP_SKILL="$HARNESS_ROOT/skills/harness-setup/SKILL.md"
if [ -f "$SETUP_SKILL" ]; then
echo " β
harness/skills/harness-setup/SKILL.md exists (includes 2agent config)"
else
echo " β harness/skills/harness-setup/SKILL.md not found"
ERRORS=$((ERRORS + 1))
fi
# ================================
# 5. Hooks configuration consistency
# ================================
echo ""
echo "πͺ [5/13] Hooks configuration consistency..."
HOOKS_JSON="$HARNESS_ROOT/hooks/hooks.json"
if [ -f "$HOOKS_JSON" ]; then
# Check script references in hooks.json
SCRIPT_REFS=$(grep -oE '\$\{CLAUDE_PLUGIN_ROOT\}/scripts/[a-zA-Z0-9_./-]+' "$HOOKS_JSON" 2>/dev/null || true)
for ref in $SCRIPT_REFS; do
script_name=$(echo "$ref" | sed 's|\${CLAUDE_PLUGIN_ROOT}/scripts/||')
if [ ! -f "$HARNESS_ROOT/scripts/$script_name" ]; then
echo " β hooks.json: Script does not exist: harness/scripts/$script_name"
ERRORS=$((ERRORS + 1))
else
echo " β
harness/scripts/$script_name"
fi
done
fi
# ================================
# 6. /start-task deprecation regression check
# ================================
echo ""
echo "π« [6/13] /start-task deprecation regression check..."
# Operational flow files (excluding history like CHANGELOG)
START_TASK_TARGETS=(
"harness/skills/"
"harness/workflows/"
"harness/templates/"
"harness/scripts/"
"README.md"
)
START_TASK_FOUND=0
for target in "${START_TASK_TARGETS[@]}"; do
if [ -e "$PLUGIN_ROOT/$target" ]; then
# Search for references to /start-task (excluding historical/explanatory context)
# Exclusion patterns: deleted/deprecated/Removed (history), equivalent/integrated/legacy/absorbed (migration notes), improvements/usage distinction (CHANGELOG)
REFS=$(grep -rn "/start-task" "$PLUGIN_ROOT/$target" 2>/dev/null \
| grep -v "ει€" | grep -v "ε»ζ’" | grep -v "Removed" \
| grep -v "ηΈε½" | grep -v "η΅±ε" | grep -v "εΎζ₯" | grep -v "εΈε" \
| grep -v "ζΉε" | grep -v "δ½Ώγεγ" | grep -v "CHANGELOG" \
| grep -v "release-this/scripts/check-consistency.sh" \
|| true)
if [ -n "$REFS" ]; then
echo " β /start-task reference still present: $target"
echo "$REFS" | head -3 | sed 's/^/ /'
START_TASK_FOUND=$((START_TASK_FOUND + 1))
fi
fi
done
if [ $START_TASK_FOUND -eq 0 ]; then
echo " β
No /start-task references (operational flow)"
else
ERRORS=$((ERRORS + START_TASK_FOUND))
fi
# ================================
# 7. docs/ normalization regression check
# ================================
echo ""
echo "π [7/13] docs/ normalization regression check..."
# Check root-level references to proposal.md / priority_matrix.md
DOCS_TARGETS=(
"harness/skills/"
)
DOCS_ISSUES=0
for target in "${DOCS_TARGETS[@]}"; do
if [ -d "$PLUGIN_ROOT/$target" ]; then
# Search for root-level references to proposal.md / technical-spec.md / priority_matrix.md
# Detect those without docs/ prefix
REFS=$(grep -rn "proposal.md\|technical-spec.md\|priority_matrix.md" "$PLUGIN_ROOT/$target" 2>/dev/null | grep -v "docs/" | grep -v "\.template" | grep -v "release-this/scripts/check-consistency.sh" || true)
if [ -n "$REFS" ]; then
echo " β Reference without docs/ prefix: $target"
echo "$REFS" | head -3 | sed 's/^/ /'
DOCS_ISSUES=$((DOCS_ISSUES + 1))
fi
fi
done
if [ $DOCS_ISSUES -eq 0 ]; then
echo " β
docs/ normalization OK"
else
ERRORS=$((ERRORS + DOCS_ISSUES))
fi
# ================================
# 8. bypassPermissions assumption regression check
# ================================
echo ""
echo "π [8/13] bypassPermissions assumption regression check..."
BYPASS_ISSUES=0
SECURITY_TEMPLATE="$HARNESS_ROOT/templates/claude/settings.security.json.template"
if [ -f "$SECURITY_TEMPLATE" ]; then
if grep -q "disableBypassPermissionsMode" "$SECURITY_TEMPLATE"; then
echo " β disableBypassPermissionsMode still present in settings.security.json.template"
echo " Please remove this setting as bypassPermissions is assumed"
BYPASS_ISSUES=$((BYPASS_ISSUES + 1))
else
echo " β
disableBypassPermissionsMode not present"
fi
fi
# Check 2: Edit / Write must not be in the permissions.ask section
# NOTE: Edit/Write in the deny section is legitimate as a double-defense. Only check ask section
if [ -f "$SECURITY_TEMPLATE" ]; then
ASK_EDIT_WRITE=$(sed -n '/"ask"/,/\]/p' "$SECURITY_TEMPLATE" | grep -E '"(Edit|Write|MultiEdit)' || true)
if [ -n "$ASK_EDIT_WRITE" ]; then
echo " β settings.security.json.template ask section contains Edit/Write"
echo " Do not include Edit/Write in ask, as bypassPermissions is assumed"
BYPASS_ISSUES=$((BYPASS_ISSUES + 1))
else
echo " β
ask section has no Edit/Write"
fi
fi
if [ -f "$SECURITY_TEMPLATE" ]; then
# Portable regex: use [(] / [*] instead of escaping to avoid BSD grep issues.
if grep -nEq 'Bash[(][^)]*[^:][*]' "$SECURITY_TEMPLATE"; then
echo " β settings.security.json.template contains invalid Bash permission syntax"
echo " Use :* for prefix matching (e.g., Bash(git status:*))"
grep -nE 'Bash[(][^)]*[^:][*]' "$SECURITY_TEMPLATE" | head -3 | sed 's/^/ /'
BYPASS_ISSUES=$((BYPASS_ISSUES + 1))
else
echo " β
Bash permission syntax OK (:*)"
fi
fi
# Check 3: settings.local.json.template must exist and defaultMode must be a documented permission mode
# NOTE: shipped default keeps bypassPermissions, Auto Mode is treated as a follow-up rollout for the teammate execution path
LOCAL_TEMPLATE="$HARNESS_ROOT/templates/claude/settings.local.json.template"
if [ -f "$LOCAL_TEMPLATE" ]; then
if grep -q '"defaultMode"[[:space:]]*:[[:space:]]*"bypassPermissions"' "$LOCAL_TEMPLATE"; then
mode_val=$(grep '"defaultMode"' "$LOCAL_TEMPLATE" | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/')
echo " β
settings.local.json.template: defaultMode=${mode_val}"
else
echo " β settings.local.json.template does not have defaultMode=bypassPermissions"
BYPASS_ISSUES=$((BYPASS_ISSUES + 1))
fi
else
echo " β settings.local.json.template does not exist"
BYPASS_ISSUES=$((BYPASS_ISSUES + 1))
fi
if [ $BYPASS_ISSUES -eq 0 ]; then
echo " β
bypassPermissions assumption OK"
else
ERRORS=$((ERRORS + BYPASS_ISSUES))
fi
# ================================
# 9. ccp-* skill deprecation regression check
# ================================
echo ""
echo "π« [9/13] ccp-* skill deprecation regression check..."
CCP_ISSUES=0
# Check 1: skills must not have name: starting with ccp-
CCP_NAMES=$(grep -rn "^name: ccp-" "$HARNESS_ROOT/skills/" 2>/dev/null || true)
if [ -n "$CCP_NAMES" ]; then
echo " β ccp-* name: still present in skills"
echo "$CCP_NAMES" | head -3 | sed 's/^/ /'
CCP_ISSUES=$((CCP_ISSUES + 1))
else
echo " β
No name: ccp-* in skills"
fi
# Check 2: workflows must not have skill: starting with ccp-
CCP_WORKFLOWS=$(grep -rn "skill: ccp-" "$HARNESS_ROOT/workflows/" 2>/dev/null || true)
if [ -n "$CCP_WORKFLOWS" ]; then
echo " β ccp-* skill: still present in workflows"
echo "$CCP_WORKFLOWS" | head -3 | sed 's/^/ /'
CCP_ISSUES=$((CCP_ISSUES + 1))
else
echo " β
No skill: ccp-* in workflows"
fi
# Check 3: ccp-* directories must not remain
CCP_DIRS=$(find "$HARNESS_ROOT/skills" -type d -name "ccp-*" 2>/dev/null || true)
if [ -n "$CCP_DIRS" ]; then
echo " β ccp-* directories still present"
echo "$CCP_DIRS" | head -3 | sed 's/^/ /'
CCP_ISSUES=$((CCP_ISSUES + 1))
else
echo " β
No ccp-* directories"
fi
if [ $CCP_ISSUES -eq 0 ]; then
echo " β
ccp-* skill deprecation OK"
else
ERRORS=$((ERRORS + CCP_ISSUES))
fi
# ================================
# 10. Template existence check
# ================================
echo ""
echo "π¦ [10/13] Template existence check..."
TEMPLATE_ISSUES=0
# Codex template
for f in "templates/codex/config.toml" "templates/codex/rules/harness.rules" "templates/codex/.codexignore" "templates/codex/AGENTS.md"; do
if [ ! -f "$HARNESS_ROOT/$f" ]; then
echo " β harness/$f not found"
TEMPLATE_ISSUES=$((TEMPLATE_ISSUES + 1))
fi
done
# OpenCode template
for f in "templates/opencode/opencode.json" "templates/opencode/AGENTS.md"; do
if [ ! -f "$HARNESS_ROOT/$f" ]; then
echo " β harness/$f not found"
TEMPLATE_ISSUES=$((TEMPLATE_ISSUES + 1))
fi
done
if [ ! -d "$HARNESS_ROOT/templates/opencode/commands" ]; then
echo " β harness/templates/opencode/commands/ not found"
TEMPLATE_ISSUES=$((TEMPLATE_ISSUES + 1))
fi
# Codex-native skill overrides
if [ ! -d "$HARNESS_ROOT/templates/codex-skills" ]; then
echo " β harness/templates/codex-skills/ not found"
TEMPLATE_ISSUES=$((TEMPLATE_ISSUES + 1))
fi
# Setup scripts
for script in "skills/harness-setup/scripts/setup-codex.sh" "skills/harness-setup/scripts/setup-opencode.sh"; do
if [ ! -f "$HARNESS_ROOT/$script" ]; then
echo " β harness/$script not found"
TEMPLATE_ISSUES=$((TEMPLATE_ISSUES + 1))
fi
done
if [ $TEMPLATE_ISSUES -eq 0 ]; then
echo " β
All templates and setup scripts present"
else
ERRORS=$((ERRORS + TEMPLATE_ISSUES))
fi
# ================================
# 11. CHANGELOG format validation
# ================================
echo ""
echo "π [11/13] CHANGELOG format validation..."
CHANGELOG_ISSUES=0
for changelog in "$PLUGIN_ROOT/CHANGELOG.md" "$PLUGIN_ROOT/CHANGELOG_ja.md"; do
if [ ! -f "$changelog" ]; then
continue
fi
cl_name=$(basename "$changelog")
# Check 1: Keep a Changelog header (## [x.y.z] - YYYY-MM-DD format)
BAD_DATES=$(grep -nE '^\#\# \[[0-9]' "$changelog" | grep -vE '[0-9]{4}-[0-9]{2}-[0-9]{2}' | grep -v "Unreleased" || true)
if [ -n "$BAD_DATES" ]; then
echo " β $cl_name: Entry with non-ISO 8601 date"
echo "$BAD_DATES" | head -3 | sed 's/^/ /'
CHANGELOG_ISSUES=$((CHANGELOG_ISSUES + 1))
fi
# Check 2: Non-standard section headings (other than the 6 types in Keep a Changelog 1.1.0)
NON_STANDARD=$(grep -nE '^\#\#\# ' "$changelog" \
| grep -viE '(Added|Changed|Deprecated|Removed|Fixed|Security|What.*Changed|γγͺγγ«γ¨γ£γ¦)' \
| grep -viE '(Internal|Breaking|Migration|Summary|Before)' \
|| true)
if [ -n "$NON_STANDARD" ]; then
echo " β οΈ $cl_name: Non-standard section headings (review recommended)"
echo "$NON_STANDARD" | head -3 | sed 's/^/ /'
# Warning only (not an error)
fi
# Check 3: [Unreleased] section must exist
if ! grep -q '^\#\# \[Unreleased\]' "$changelog"; then
echo " β $cl_name: [Unreleased] section is missing"
CHANGELOG_ISSUES=$((CHANGELOG_ISSUES + 1))
fi
done
if [ $CHANGELOG_ISSUES -eq 0 ]; then
echo " β
CHANGELOG format OK"
else
ERRORS=$((ERRORS + CHANGELOG_ISSUES))
fi
# ================================
# 12. README claim drift check
# ================================
echo ""
echo "π [12/13] README claim drift check..."
README_ISSUES=0
README_EN="$PLUGIN_ROOT/README.md"
SCOPE_DOC="$PLUGIN_ROOT/docs/distribution-scope.md"
RUBRIC_DOC="$PLUGIN_ROOT/docs/benchmark-rubric.md"
POSITIONING_DOC="$PLUGIN_ROOT/docs/positioning-notes.md"
WORK_ALL_DOC="$PLUGIN_ROOT/docs/evidence/work-all.md"
check_fixed_string() {
local file_path="$1"
local needle="$2"
local label="$3"
if [ ! -f "$file_path" ]; then
echo " β ${label}: File does not exist: $file_path"
README_ISSUES=$((README_ISSUES + 1))
return
fi
if grep -qF "$needle" "$file_path"; then
echo " β
${label}"
else
echo " β ${label}: Required string not found"
README_ISSUES=$((README_ISSUES + 1))
fi
}
check_absent_string() {
local file_path="$1"
local needle="$2"
local label="$3"
if [ ! -f "$file_path" ]; then
echo " β ${label}: File does not exist: $file_path"
README_ISSUES=$((README_ISSUES + 1))
return
fi
if grep -qF "$needle" "$file_path"; then
echo " β ${label}: Stale claim still present"
README_ISSUES=$((README_ISSUES + 1))
else
echo " β
${label}"
fi
}
check_exists() {
local file_path="$1"
local label="$2"
if [ -f "$file_path" ]; then
echo " β
${label}"
else
echo " β ${label}: File does not exist"
README_ISSUES=$((README_ISSUES + 1))
fi
}
check_fixed_string "$README_EN" "$LATEST_RELEASE_URL" "README.md latest release link"
check_fixed_string "$README_EN" "$LATEST_RELEASE_BADGE" "README.md latest release badge"
check_exists "$SCOPE_DOC" "distribution-scope.md"
check_exists "$RUBRIC_DOC" "benchmark-rubric.md"
check_exists "$POSITIONING_DOC" "positioning-notes.md"
check_exists "$WORK_ALL_DOC" "work-all evidence doc"
check_fixed_string "$README_EN" "docs/CLAUDE_CODE_COMPATIBILITY.md" "README.md compatibility doc link"
check_fixed_string "$README_EN" "docs/evidence/work-all.md" "README.md work-all evidence link"
check_fixed_string "$README_EN" "Go-native guardrail engine" "README.md Go-native guardrail engine message"
check_absent_string "$README_EN" "Production-ready code." "README.md stale production-ready wording"
check_fixed_string "$SCOPE_DOC" '| `commands/` | Compatibility-retained |' "distribution-scope commands classification"
check_fixed_string "$SCOPE_DOC" '| `mcp-server/` | Development-only and distribution-excluded |' "distribution-scope mcp-server classification"
check_fixed_string "$RUBRIC_DOC" "| Static evidence |" "benchmark-rubric static evidence"
check_fixed_string "$RUBRIC_DOC" "| Executed evidence |" "benchmark-rubric executed evidence"
check_fixed_string "$POSITIONING_DOC" "runtime enforcement" "positioning-notes runtime enforcement"
if [ $README_ISSUES -eq 0 ]; then
echo " β
README claim drift check OK"
else
ERRORS=$((ERRORS + README_ISSUES))
fi
# ================================
# 13. EN/JA visual sync check
# ================================
echo ""
echo "π¨ [13/13] EN/JA visual sync check..."
VISUAL_EN_DIR="$PLUGIN_ROOT/docs/assets/readme-visuals-en/generated"
VISUAL_JA_DIR="$PLUGIN_ROOT/docs/assets/readme-visuals-ja/generated"
VISUAL_ISSUES=0
if [ -d "$VISUAL_EN_DIR" ] && [ -d "$VISUAL_JA_DIR" ]; then
# Verify that files present in EN also exist in JA and that viewBox sizes match
for en_svg in "$VISUAL_EN_DIR"/*.svg; do
[ ! -f "$en_svg" ] && continue
svg_name=$(basename "$en_svg")
ja_svg="$VISUAL_JA_DIR/$svg_name"
if [ ! -f "$ja_svg" ]; then
echo " β JA version missing: $svg_name"
VISUAL_ISSUES=$((VISUAL_ISSUES + 1))
continue
fi
# Compare viewBox heights (detect significant structural divergence)
en_viewbox=$(grep -o 'viewBox="[^"]*"' "$en_svg" | head -1)
ja_viewbox=$(grep -o 'viewBox="[^"]*"' "$ja_svg" | head -1)
if [ "$en_viewbox" != "$ja_viewbox" ]; then
echo " β οΈ viewBox mismatch: $svg_name (EN: $en_viewbox / JA: $ja_viewbox)"
# Warning only (height differences are acceptable since Japanese characters have different widths)
fi
# Compare table row counts (simple check using count of <rect y=)
en_rows=$(grep -c '<rect y=' "$en_svg" 2>/dev/null || echo 0)
ja_rows=$(grep -c '<rect y=' "$ja_svg" 2>/dev/null || echo 0)
if [ "$en_rows" != "$ja_rows" ]; then
echo " β Row count mismatch: $svg_name (EN: ${en_rows} rows / JA: ${ja_rows} rows)"
VISUAL_ISSUES=$((VISUAL_ISSUES + 1))
else
echo " β
$svg_name (${en_rows} rows)"
fi
done
else
echo " β οΈ EN/JA visual directories not found (skipping)"
fi
if [ $VISUAL_ISSUES -gt 0 ]; then
ERRORS=$((ERRORS + VISUAL_ISSUES))
fi
# ================================
# Result summary
# ================================
echo ""
echo "ββββββββββββββββββββββββββββββββββββββββ"
if [ $ERRORS -eq 0 ]; then
echo "β
All checks passed"
exit 0
else
echo "β $ERRORS issue(s) found"
exit 1
fi
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |