#!/bin/bash
|
# Skill Extraction Helper
|
# Creates a new skill from a learning entry
|
# Usage: ./extract-skill.sh <skill-name> [--dry-run]
|
|
set -e
|
|
# Configuration
|
SKILLS_DIR="./skills"
|
|
# Colors for output
|
RED='\033[0;31m'
|
GREEN='\033[0;32m'
|
YELLOW='\033[1;33m'
|
NC='\033[0m' # No Color
|
|
usage() {
|
cat << EOF
|
Usage: $(basename "$0") <skill-name> [options]
|
|
Create a new skill from a learning entry.
|
|
Arguments:
|
skill-name Name of the skill (lowercase, hyphens for spaces)
|
|
Options:
|
--dry-run Show what would be created without creating files
|
--output-dir Relative output directory under current path (default: ./skills)
|
-h, --help Show this help message
|
|
Examples:
|
$(basename "$0") docker-m1-fixes
|
$(basename "$0") api-timeout-patterns --dry-run
|
$(basename "$0") pnpm-setup --output-dir ./skills/custom
|
|
The skill will be created in: \$SKILLS_DIR/<skill-name>/
|
EOF
|
}
|
|
log_info() {
|
echo -e "${GREEN}[INFO]${NC} $1"
|
}
|
|
log_warn() {
|
echo -e "${YELLOW}[WARN]${NC} $1"
|
}
|
|
log_error() {
|
echo -e "${RED}[ERROR]${NC} $1" >&2
|
}
|
|
# Parse arguments
|
SKILL_NAME=""
|
DRY_RUN=false
|
|
while [[ $# -gt 0 ]]; do
|
case $1 in
|
--dry-run)
|
DRY_RUN=true
|
shift
|
;;
|
--output-dir)
|
if [ -z "${2:-}" ] || [[ "${2:-}" == -* ]]; then
|
log_error "--output-dir requires a relative path argument"
|
usage
|
exit 1
|
fi
|
SKILLS_DIR="$2"
|
shift 2
|
;;
|
-h|--help)
|
usage
|
exit 0
|
;;
|
-*)
|
log_error "Unknown option: $1"
|
usage
|
exit 1
|
;;
|
*)
|
if [ -z "$SKILL_NAME" ]; then
|
SKILL_NAME="$1"
|
else
|
log_error "Unexpected argument: $1"
|
usage
|
exit 1
|
fi
|
shift
|
;;
|
esac
|
done
|
|
# Validate skill name
|
if [ -z "$SKILL_NAME" ]; then
|
log_error "Skill name is required"
|
usage
|
exit 1
|
fi
|
|
# Validate skill name format (lowercase, hyphens, no spaces)
|
if ! [[ "$SKILL_NAME" =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
|
log_error "Invalid skill name format. Use lowercase letters, numbers, and hyphens only."
|
log_error "Examples: 'docker-fixes', 'api-patterns', 'pnpm-setup'"
|
exit 1
|
fi
|
|
# Validate output path to avoid writes outside current workspace.
|
if [[ "$SKILLS_DIR" = /* ]]; then
|
log_error "Output directory must be a relative path under the current directory."
|
exit 1
|
fi
|
|
if [[ "$SKILLS_DIR" =~ (^|/)\.\.(/|$) ]]; then
|
log_error "Output directory cannot include '..' path segments."
|
exit 1
|
fi
|
|
SKILLS_DIR="${SKILLS_DIR#./}"
|
SKILLS_DIR="./$SKILLS_DIR"
|
|
SKILL_PATH="$SKILLS_DIR/$SKILL_NAME"
|
|
# Check if skill already exists
|
if [ -d "$SKILL_PATH" ] && [ "$DRY_RUN" = false ]; then
|
log_error "Skill already exists: $SKILL_PATH"
|
log_error "Use a different name or remove the existing skill first."
|
exit 1
|
fi
|
|
# Dry run output
|
if [ "$DRY_RUN" = true ]; then
|
log_info "Dry run - would create:"
|
echo " $SKILL_PATH/"
|
echo " $SKILL_PATH/SKILL.md"
|
echo ""
|
echo "Template content would be:"
|
echo "---"
|
cat << TEMPLATE
|
name: $SKILL_NAME
|
description: "[TODO: Add a concise description of what this skill does and when to use it]"
|
---
|
|
# $(echo "$SKILL_NAME" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1')
|
|
[TODO: Brief introduction explaining the skill's purpose]
|
|
## Quick Reference
|
|
| Situation | Action |
|
|-----------|--------|
|
| [Trigger condition] | [What to do] |
|
|
## Usage
|
|
[TODO: Detailed usage instructions]
|
|
## Examples
|
|
[TODO: Add concrete examples]
|
|
## Source Learning
|
|
This skill was extracted from a learning entry.
|
- Learning ID: [TODO: Add original learning ID]
|
- Original File: .learnings/LEARNINGS.md
|
TEMPLATE
|
echo "---"
|
exit 0
|
fi
|
|
# Create skill directory structure
|
log_info "Creating skill: $SKILL_NAME"
|
|
mkdir -p "$SKILL_PATH"
|
|
# Create SKILL.md from template
|
cat > "$SKILL_PATH/SKILL.md" << TEMPLATE
|
---
|
name: $SKILL_NAME
|
description: "[TODO: Add a concise description of what this skill does and when to use it]"
|
---
|
|
# $(echo "$SKILL_NAME" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1')
|
|
[TODO: Brief introduction explaining the skill's purpose]
|
|
## Quick Reference
|
|
| Situation | Action |
|
|-----------|--------|
|
| [Trigger condition] | [What to do] |
|
|
## Usage
|
|
[TODO: Detailed usage instructions]
|
|
## Examples
|
|
[TODO: Add concrete examples]
|
|
## Source Learning
|
|
This skill was extracted from a learning entry.
|
- Learning ID: [TODO: Add original learning ID]
|
- Original File: .learnings/LEARNINGS.md
|
TEMPLATE
|
|
log_info "Created: $SKILL_PATH/SKILL.md"
|
|
# Suggest next steps
|
echo ""
|
log_info "Skill scaffold created successfully!"
|
echo ""
|
echo "Next steps:"
|
echo " 1. Edit $SKILL_PATH/SKILL.md"
|
echo " 2. Fill in the TODO sections with content from your learning"
|
echo " 3. Add references/ folder if you have detailed documentation"
|
echo " 4. Add scripts/ folder if you have executable code"
|
echo " 5. Update the original learning entry with:"
|
echo " **Status**: promoted_to_skill"
|
echo " **Skill-Path**: skills/$SKILL_NAME"
|
