local-skills-setup

Files (1)

• SKILL.md

SKILL.md (first lines)

# Local Skills Setup

This skill provides a guided wizard for setting up and managing your local learned skills. Skills are reusable problem-solving patterns that the agent automatically applies when it detects matching triggers.

## Why Local Skills?

Local skills allow you to capture hard-won insights and solutions that are specific to your codebase or workflow:
- **Project-level skills** (.agents/skills/droid-learned/) - Version-controlled with your repo
- **User-level skills** (~/.agents/skills/droid-learned/) - Portable across all your projects

When you solve a tricky bug or discover a non-obvious workaround, you can extract it as a skill. The agent will automatically detect and apply these skills in future conversations when it sees matching triggers.

## Interactive Workflow

### Step 1: Directory Check and Setup

First, check if skill directories exist and create them if needed:

```bash
# Check and create user-level skills directory
USER_SKILLS_DIR="$HOME/.agents/skills/droid-learned"
if [ -d "$USER_SKILLS_DIR" ]; then
  echo "User skills directory exists: $USER_SKILLS_DIR"
else
  mkdir -p "$USER_SKILLS_DIR"
  echo "Created user skills directory: $USER_SKILLS_DIR"
fi

# Check and create project-level skills directory
PROJECT_SKILLS_DIR=".agents/skills/droid-learned"
if [ -d "$PROJECT_SKILLS_DIR" ]; then
  echo "Project skills directory exists: $PROJECT_SKILLS_DIR"
else
  mkdir -p "$PROJECT_SKILLS_DIR"
  echo "Created project skills directory: $PROJECT_SKILLS_DIR"
fi
```

### Step 2: Skill Scan and Inventory

Scan canonical directories first, then legacy fallbacks. Deduplicate by the
path relative to each source directory so migrated copies win while distinct
nested skills remain visible.

```bash
SEEN_FILE=$(mktemp)
trap 'rm -f "$SEEN_FILE"' EXIT

scan_skill_dir() {
  SCOPE="$1"
  DIR="$2"
  [ -d "$DIR" ] || return

  while IFS= read -r FILE; do
    RELATIVE_PATH="${FILE#"$DIR"/}"
    IDENTITY="$SCOPE:$RELATIVE_PATH"
    grep -Fqx "$IDENTITY" "$SEEN_FILE" && continue
    printf '%s\n' "$IDENTITY" >> "$SEEN_FILE"

    NAME=$(grep -m1 "^name:" "$FILE" 2>/dev/null | sed "s/name: //")
    DESC=$(grep -m1 "^description:" "$FILE" 2>/dev/null | sed "s/description: //")
    MODIFIED=$(stat -c "%y" "$FILE" 2>/dev/null || stat -f "%Sm" "$FILE" 2>/dev/null)
    echo "  - ${NAME:-$(basename "$FILE")}"
    [ -n "$DESC" ] && echo "    Description: $DESC"
    echo "    Path: $FILE"
    echo "    Modified: $MODIFIED"
    echo ""
  done < <(find "$DIR" -name "*.md" -type f 2>/dev/null)
}

echo "=== USER-LEVEL SKILLS ==="
scan_skill_dir user "$HOME/.agents/skills/droid-learned"
scan_skill_dir user "$HOME/.factory/skills/droid-learned"
scan_skill_dir user "$HOME/.factory/skills/omc-learned"
scan_skill_dir user "$HOME/.omd/skills"

echo "=== PROJECT-LEVEL SKILLS ==="
scan_skill_dir project ".agents/skills/droid-learned"
scan_skill_dir project ".omd/skills"

USER_COUNT=$(grep -c '^user:' "$SEEN_FILE" 2>/dev/null || true)
PROJECT_COUNT=$(grep -c '^project:' "$SEEN_FILE" 2>/dev/null || true)
TOTAL=$((USER_COUNT + PROJECT_COUNT))
echo "=== SUMMARY ==="
echo "Total skills across all directories: $TOTAL"
```

### Step 3: Quick Actions Menu

After scanning, use the AskUserQuestion tool to offer these options:

**Question:** "What would you like to do with your local skills?"

**Options:**
1. **Add new skill** - Start the skill creation wizard
2. **List all skills with details** - Show comprehensive skill inventory with triggers
3. **Scan conversation for patterns** - Analyze current conversation for skill-worthy patterns
4. **Import skill** - Import a skill from URL or paste content
5. **Done** - Exit the wizard

#### Option 1: Add New Skill

If user chooses "Add new skill", invoke the learner skill:

```
Use the Skill tool to invoke: learner
```

This will guide them through the extraction process with quality validation.

#### Option 2: List All Skills with Details

Show detailed information including trigger keywords:

```bash
echo "=== DETAILED SKILL INVENTORY ==="
echo ""

# Function to show skill details

From MeroZemory/oh-my-droid, MIT.

More from MeroZemory/oh-my-droid