Defame1297
08abe9920a
- script: new-skill.sh now exits 0 when target already exists (idempotent retry-safe) instead of exit 1; --help updated to reflect narrowed error cases - test: updated bats test to assert success and "nothing to do" output - body: removed speculative "Extract the skill from a real task" advice (human-targeted, not agent-actionable) - formatting: converted H4 headings in Step 2 to bold text (H2/H3 two-tier model) - provenance: removed orphan agentskills-llms-txt entry from references/sources.md; added discovery-only comment Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
89 lines
2.7 KiB
Bash
Executable File
89 lines
2.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
TEMPLATES_DIR="$SKILL_DIR/../assets/templates"
|
|
|
|
usage() {
|
|
cat <<EOF
|
|
Usage: new-skill.sh <skill-name> <destination-dir>
|
|
|
|
Create a new skill scaffold by copying annotated templates to the destination.
|
|
|
|
Arguments:
|
|
skill-name Kebab-case skill identifier (e.g. my-tool, data-analyzer).
|
|
Must match the directory name exactly.
|
|
destination-dir Parent directory to create the skill in.
|
|
Examples: ~/.agents/skills/ plugins/myplugin/skills/
|
|
|
|
Output:
|
|
Creates <destination-dir>/<skill-name>/ with annotated templates ready to fill in.
|
|
|
|
Exit codes:
|
|
0 Scaffold created successfully, or destination already exists (no-op)
|
|
1 Invalid arguments, missing destination parent, or templates not found
|
|
EOF
|
|
}
|
|
|
|
if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
|
|
usage
|
|
exit 0
|
|
fi
|
|
|
|
if [[ $# -lt 2 ]]; then
|
|
echo "Error: skill-name and destination-dir are required." >&2
|
|
echo "" >&2
|
|
usage >&2
|
|
exit 1
|
|
fi
|
|
|
|
SKILL_NAME="$1"
|
|
DEST_DIR="$2"
|
|
|
|
# Validate skill name format
|
|
if ! echo "$SKILL_NAME" | grep -qE '^[a-z0-9]+(-[a-z0-9]+)*$'; then
|
|
echo "Error: skill-name must use lowercase letters, numbers, and hyphens only." >&2
|
|
echo " No leading, trailing, or consecutive hyphens." >&2
|
|
echo " Received: '$SKILL_NAME'" >&2
|
|
exit 1
|
|
fi
|
|
|
|
# Validate templates directory exists
|
|
if [[ ! -d "$TEMPLATES_DIR" ]]; then
|
|
echo "Error: templates directory not found at '$TEMPLATES_DIR'." >&2
|
|
echo " Run this script from its original location inside the skill-author skill." >&2
|
|
exit 1
|
|
fi
|
|
|
|
# Validate destination exists
|
|
if [[ ! -d "$DEST_DIR" ]]; then
|
|
echo "Error: destination directory '$DEST_DIR' does not exist." >&2
|
|
exit 1
|
|
fi
|
|
|
|
TARGET="$DEST_DIR/$SKILL_NAME"
|
|
|
|
# Destination already exists — treat as a no-op so retries are safe
|
|
if [[ -d "$TARGET" ]]; then
|
|
echo "Scaffold already exists at '$TARGET' — nothing to do." >&2
|
|
exit 0
|
|
fi
|
|
|
|
# Copy templates to destination
|
|
cp -r "$TEMPLATES_DIR" "$TARGET"
|
|
|
|
# Set skill name in templates
|
|
sed -i "s/SKILL_NAME/$SKILL_NAME/g" "$TARGET/SKILL.md"
|
|
sed -i "s/SKILL_NAME/$SKILL_NAME/g" "$TARGET/README.md"
|
|
sed -i "s/SKILL_NAME/$SKILL_NAME/g" "$TARGET/tests/README.md"
|
|
|
|
echo "Scaffold created: $TARGET" >&2
|
|
echo "" >&2
|
|
echo "Next steps:" >&2
|
|
echo " 1. Fill in $TARGET/SKILL.md — replace all FILL IN: placeholders" >&2
|
|
echo " 2. Add scripts to scripts/ if needed (or delete the directory)" >&2
|
|
echo " 3. Add docs to references/ if needed (or delete the directory)" >&2
|
|
echo " 4. Add resources to assets/ if needed (or delete the directory)" >&2
|
|
echo " 5. Add tests to tests/ if the skill has scripts (or delete the directory)" >&2
|
|
echo " 6. Validate: run /skill-audit on $TARGET" >&2
|