Skill Discovery (SkillForge)

Automatically discovers, evaluates, and generates integration manifests for new PopeBot-compatible skills from GitHub repositories.

Overview

This skill implements a simplified version of ZeroClaw's SkillForge system. It:

Scouts GitHub for skill-related repositories
Evaluates candidates across multiple dimensions (compatibility, quality, security)
Generates PopeBot-compatible SKILL.md manifests for qualified candidates

Usage

Discover Skills

# Basic discovery (searches for "thepopebot skill" and "ai agent skill")
{baseDir}/discover.js

# Search with custom queries
{baseDir}/discover.js --query "popebot automation"

# Show detailed output
{baseDir}/discover.js --verbose

# Limit results
{baseDir}/discover.js --limit 10

Evaluate a Specific Repository

# Evaluate a single repo by URL
{baseDir}/evaluate.js https://github.com/user/repo-name

# Evaluate with custom scoring weights
{baseDir}/evaluate.js https://github.com/user/repo-name --min-score 0.6

Generate Skill Manifest

# Generate SKILL.md from a evaluated candidate
{baseDir}/generate.js --name "skill-name" --url "https://github.com/user/repo" --description "What it does"

Scoring Dimensions

Skills are evaluated on three dimensions (each 0.0-1.0):

Dimension	Weight	Factors
Compatibility	30%	Language (JavaScript/TypeScript favored), runtime requirements
Quality	35%	Star count (log scale), documentation, test coverage
Security	35%	License presence, bad pattern detection, update recency

Recommendations

Auto (score ≥ 0.7): Safe to auto-integrate
Manual (0.4 ≤ score < 0.7): Needs human review
Skip (score < 0.4): Not recommended

Output Format

=== SkillForge Discovery Report ===
Discovered: 5 candidates
Evaluated: 5 candidates
Auto-integratable: 2
Manual review: 2
Skipped: 1

--- Candidates ---

1. example-skill ⭐ AUTO (0.82)
   URL: https://github.com/user/example-skill
   Language: JavaScript | Stars: 156 | License: MIT
   Scores: Compatibility=1.0, Quality=0.72, Security=0.8

2. another-skill ⚠️ MANUAL (0.55)
   URL: https://github.com/user/another-skill
   Language: Python | Stars: 23 | License: None
   Scores: Compatibility=0.6, Quality=0.45, Security=0.5

3. low-quality ⛔ SKIP (0.28)
   URL: https://github.com/user/low-quality
   Language: Unknown | Stars: 1 | License: None
   Scores: Compatibility=0.2, Quality=0.15, Security=0.3

Installation

cd {baseDir}
npm install

When to Use

When you want to find new skills for PopeBot
When exploring the skill ecosystem
When you need to evaluate a skill before integrating
When building automated skill management workflows

Example Workflow

# 1. Discover new skills
{baseDir}/discover.js --limit 20 --verbose > /job/tmp/skill-candidates.md

# 2. Review the report
cat /job/tmp/skill-candidates.md

# 3. Evaluate a promising candidate in detail
{baseDir}/evaluate.js https://github.com/user/promising-skill

# 4. Generate integration manifest for approved skills
{baseDir}/generate.js --name "promising-skill" \
  --url "https://github.com/user/promising-skill" \
  --description "Does something useful"

# 5. Move generated manifest to pi-skills/ and create symlink
mv /job/tmp/skills/promising-skill/SKILL.md /job/pi-skills/promising-skill/
ln -s ../../pi-skills/promising-skill /job/.pi/skills/promising-skill

Configuration

Set these environment variables for customization:

GITHUB_TOKEN - Personal access token for higher API rate limits
SKILLFORGE_MIN_SCORE - Minimum score for auto recommendation (default: 0.7)
SKILLFORGE_OUTPUT_DIR - Output directory for generated manifests (default: /job/tmp/skills)

Security Notes

Skills containing bad patterns (malware, exploit, etc.) are automatically flagged
Missing licenses reduce security scores significantly
Repositories not updated in 180+ days receive recency penalties

skill-discovery