Skip to content

monte-carlo-data/mc-agent-toolkit / .claude/skills/toolkit-skill-author

toolkit-skill-author

Verified

Authors or extends a skill in mc-agent-toolkit. Gates for forbidden buckets and name collisions, applies CONTRIBUTING's extend-or-split rules, then edits a peer skill or hands off to Anthropic's skill-creator and walks the registration checklist.

scripts/tests/smoke-test.sh

View on GitHub
#!/usr/bin/env bash
# Verify every path and script that toolkit-skill-author's SKILL.md references still exists
# and behaves as expected. Catches drift when registration targets move or scripts
# are renamed — without this, toolkit-skill-author would fail silently mid-flow.
#
# Run from repo root:  bash .claude/skills/toolkit-skill-author/scripts/smoke-test.sh
# Exits 0 on pass, 1 on any failure.
set -u

SKILL_DIR=".claude/skills/toolkit-skill-author"
fail=0

assert_file() {
  if [ ! -f "$1" ]; then
    echo "FAIL: missing file $1"
    fail=1
  fi
}

assert_dir() {
  if [ ! -d "$1" ]; then
    echo "FAIL: missing dir $1"
    fail=1
  fi
}

assert_script_runs() {
  local label="$1"; shift
  if ! "$@" >/dev/null 2>&1; then
    echo "FAIL: $label — '$*' exited non-zero"
    fail=1
  fi
}

# Core toolkit-skill-author files
assert_file "CONTRIBUTING.md"
assert_file "$SKILL_DIR/SKILL.md"
assert_file "$SKILL_DIR/references/decision-rules.md"
assert_file "$SKILL_DIR/references/handoff-preamble.md"
assert_file "$SKILL_DIR/references/registration-checklist.md"
assert_file "$SKILL_DIR/scripts/find-peers.sh"
assert_file "$SKILL_DIR/scripts/lint-skill.py"

# Registration-checklist targets (referenced in registration-checklist.md)
assert_file "skills/context-detection/references/signal-definitions.md"
assert_file "plugins/claude-code/commands/catalog/mc.md"
assert_file "plugins/claude-code/.claude-plugin/plugin.json"
assert_file "scripts/bump-version.sh"

# Editor-plugin dirs for symlinks (registration-checklist step 4)
for editor in claude-code cursor codex opencode; do
  assert_dir "plugins/$editor/skills"
done

# Scripts run without crashing on valid input
assert_script_runs "find-peers.sh dumps skills" bash "$SKILL_DIR/scripts/find-peers.sh" skills

# Lint against a synthetic compliant skill (real skills in skills/ have legacy
# version/bucket debt that the linter correctly flags — not what this test
# measures).
FIXTURE=$(mktemp -d)
mkdir -p "$FIXTURE/smoke-fixture"
cat > "$FIXTURE/smoke-fixture/SKILL.md" <<'EOF'
---
name: monte-carlo-smoke-fixture
description: A fixture skill for smoke-testing lint-skill.py.
when_to_use: When smoke-testing.
bucket: Monitoring
---
EOF
assert_script_runs "lint-skill.py accepts a compliant skill" python3 "$SKILL_DIR/scripts/lint-skill.py" smoke-fixture "$FIXTURE"
rm -rf "$FIXTURE"

if [ "$fail" -eq 0 ]; then
  echo "toolkit-skill-author smoke test: OK"
  exit 0
else
  echo "toolkit-skill-author smoke test: FAILED"
  exit 1
fi
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall