1#!/bin/bash
2# Skill Extraction Helper
3# Creates a new skill from a learning entry
4# Usage: ./extract-skill.sh <skill-name> [--dry-run]
5 
6set -e
7 
8# Configuration
9SKILLS_DIR="./skills"
10 
11# Colors for output
12RED='\033[0;31m'
13GREEN='\033[0;32m'
14YELLOW='\033[1;33m'
15NC='\033[0m' # No Color
16 
17usage() {
18    cat << EOF
19Usage: $(basename "$0") <skill-name> [options]
20 
21Create a new skill from a learning entry.
22 
23Arguments:
24  skill-name     Name of the skill (lowercase, hyphens for spaces)
25 
26Options:
27  --dry-run      Show what would be created without creating files
28  --output-dir   Relative output directory under current path (default: ./skills)
29  -h, --help     Show this help message
30 
31Examples:
32  $(basename "$0") docker-m1-fixes
33  $(basename "$0") api-timeout-patterns --dry-run
34  $(basename "$0") pnpm-setup --output-dir ./skills/custom
35 
36The skill will be created in: \$SKILLS_DIR/<skill-name>/
37EOF
38}
39 
40log_info() {
41    echo -e "${GREEN}[INFO]${NC} $1"
42}
43 
44log_warn() {
45    echo -e "${YELLOW}[WARN]${NC} $1"
46}
47 
48log_error() {
49    echo -e "${RED}[ERROR]${NC} $1" >&2
50}
51 
52# Parse arguments
53SKILL_NAME=""
54DRY_RUN=false
55 
56while [[ $# -gt 0 ]]; do
57    case $1 in
58        --dry-run)
59            DRY_RUN=true
60            shift
61            ;;
62        --output-dir)
63            if [ -z "${2:-}" ] || [[ "${2:-}" == -* ]]; then
64                log_error "--output-dir requires a relative path argument"
65                usage
66                exit 1
67            fi
68            SKILLS_DIR="$2"
69            shift 2
70            ;;
71        -h|--help)
72            usage
73            exit 0
74            ;;
75        -*)
76            log_error "Unknown option: $1"
77            usage
78            exit 1
79            ;;
80        *)
81            if [ -z "$SKILL_NAME" ]; then
82                SKILL_NAME="$1"
83            else
84                log_error "Unexpected argument: $1"
85                usage
86                exit 1
87            fi
88            shift
89            ;;
90    esac
91done
92 
93# Validate skill name
94if [ -z "$SKILL_NAME" ]; then
95    log_error "Skill name is required"
96    usage
97    exit 1
98fi
99 
100# Validate skill name format (lowercase, hyphens, no spaces)
101if ! [[ "$SKILL_NAME" =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
102    log_error "Invalid skill name format. Use lowercase letters, numbers, and hyphens only."
103    log_error "Examples: 'docker-fixes', 'api-patterns', 'pnpm-setup'"
104    exit 1
105fi
106 
107# Validate output path to avoid writes outside current workspace.
108if [[ "$SKILLS_DIR" = /* ]]; then
109    log_error "Output directory must be a relative path under the current directory."
110    exit 1
111fi
112 
113if [[ "$SKILLS_DIR" =~ (^|/)\.\.(/|$) ]]; then
114    log_error "Output directory cannot include '..' path segments."
115    exit 1
116fi
117 
118SKILLS_DIR="${SKILLS_DIR#./}"
119SKILLS_DIR="./$SKILLS_DIR"
120 
121SKILL_PATH="$SKILLS_DIR/$SKILL_NAME"
122 
123# Check if skill already exists
124if [ -d "$SKILL_PATH" ] && [ "$DRY_RUN" = false ]; then
125    log_error "Skill already exists: $SKILL_PATH"
126    log_error "Use a different name or remove the existing skill first."
127    exit 1
128fi
129 
130# Dry run output
131if [ "$DRY_RUN" = true ]; then
132    log_info "Dry run - would create:"
133    echo "  $SKILL_PATH/"
134    echo "  $SKILL_PATH/SKILL.md"
135    echo ""
136    echo "Template content would be:"
137    echo "---"
138    cat << TEMPLATE
139name: $SKILL_NAME
140description: "[TODO: Add a concise description of what this skill does and when to use it]"
141---
142 
143# $(echo "$SKILL_NAME" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1')
144 
145[TODO: Brief introduction explaining the skill's purpose]
146 
147## Quick Reference
148 
149| Situation | Action |
150|-----------|--------|
151| [Trigger condition] | [What to do] |
152 
153## Usage
154 
155[TODO: Detailed usage instructions]
156 
157## Examples
158 
159[TODO: Add concrete examples]
160 
161## Source Learning
162 
163This skill was extracted from a learning entry.
164- Learning ID: [TODO: Add original learning ID]
165- Original File: .learnings/LEARNINGS.md
166TEMPLATE
167    echo "---"
168    exit 0
169fi
170 
171# Create skill directory structure
172log_info "Creating skill: $SKILL_NAME"
173 
174mkdir -p "$SKILL_PATH"
175 
176# Create SKILL.md from template
177cat > "$SKILL_PATH/SKILL.md" << TEMPLATE
178---
179name: $SKILL_NAME
180description: "[TODO: Add a concise description of what this skill does and when to use it]"
181---
182 
183# $(echo "$SKILL_NAME" | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1')
184 
185[TODO: Brief introduction explaining the skill's purpose]
186 
187## Quick Reference
188 
189| Situation | Action |
190|-----------|--------|
191| [Trigger condition] | [What to do] |
192 
193## Usage
194 
195[TODO: Detailed usage instructions]
196 
197## Examples
198 
199[TODO: Add concrete examples]
200 
201## Source Learning
202 
203This skill was extracted from a learning entry.
204- Learning ID: [TODO: Add original learning ID]
205- Original File: .learnings/LEARNINGS.md
206TEMPLATE
207 
208log_info "Created: $SKILL_PATH/SKILL.md"
209 
210# Suggest next steps
211echo ""
212log_info "Skill scaffold created successfully!"
213echo ""
214echo "Next steps:"
215echo "  1. Edit $SKILL_PATH/SKILL.md"
216echo "  2. Fill in the TODO sections with content from your learning"
217echo "  3. Add references/ folder if you have detailed documentation"
218echo "  4. Add scripts/ folder if you have executable code"
219echo "  5. Update the original learning entry with:"
220echo "     **Status**: promoted_to_skill"
221echo "     **Skill-Path**: skills/$SKILL_NAME"
222