Skill Index Manager

Automated OpenClaw skills index management system. Scans, parses, and regenerates all skill index files including markdown catalogs, JSON indices, and category-organized symbolic links.

Installation

cd ~/.openclaw/workspace/skills/task-index-manager
npm install

Usage

CLI Commands

# Scan skills directory
skill-index-manager scan

# Update all index files
skill-index-manager update

# List all skills
skill-index-manager list

# Search skills by keyword
skill-index-manager search memory

# Validate index integrity
skill-index-manager validate

# Initialize directory structure
skill-index-manager init

Options

# Specify custom paths
skill-index-manager scan --path /custom/skills/path
skill-index-manager update --skills-path /custom/skills --output /custom/output

# Output formats
skill-index-manager list --format json
skill-index-manager list --format table

Programmatic API

const { SkillScanner, SkillParser, IndexGenerator, CategoryManager } = require('./lib');

// Scan skills
const scanner = new SkillScanner();
const result = scanner.scan();

// Parse metadata
const parser = new SkillParser();
const metadata = parser.parse('skills/my-skill/SKILL.md');

// Generate index
const generator = new IndexGenerator();
generator.generateAll(skills, 'output/path');

// Manage categories
const categoryManager = new CategoryManager();
categoryManager.updateAllSymlinks(skills, 'output/path', 'skills/path');

Generated Files

The following files are generated in the output directory:

• SKILLS_INDEX.md - Complete skill catalog with descriptions
• QUICK_REFERENCE.md - Concise reference cards
• skills.json - Machine-readable index
• by_category/ - Symbolic links organized by category

Categories

Skills are automatically categorized into:

1. Core (01_core) - Infrastructure, docs, validation
2. Memory (02_memory) - Persistence, caching
3. Notion (03_notion) - Notion integration
4. Task Workflow (04_task_workflow) - Scheduling, development
5. Document (05_document) - File processing
6. Security (06_security) - Auditing, scanning
7. Publishing (07_publishing) - Distribution

Testing

# Run all tests
npm test

# Run unit tests only
npm run test:unit

# Run with coverage
npm run test:coverage

Cron Configuration

Recommended monthly execution:

# Add to crontab (monthly on 1st at 00:00)
0 0 1 * * cd ~/.openclaw/workspace/skills/task-index-manager && node bin/skill-index-manager.js update

Or use OpenClaw cron API:

{
  "name": "skill-index-monthly-update",
  "schedule": "0 0 1 * *",
  "command": "skill-index-manager update"
}

License

MIT