foryourhealth111-pixel/Vibe-Skills

VibeSkills is a general-purpose Skill that automatically routes local Skills and intelligently orchestrates harness workflows.

What it solves

VibeSkills is a general-purpose orchestration layer for local AI "Skills" (reusable experience assets). It solves the problem of "skill fatigue" where users forget which local skills they have installed or struggle to manually plan how to combine multiple domain-specific skills to complete a complex, multi-step task.

How it works

VibeSkills acts as a steward between the user's task and their local skill library. It follows a structured process:

  1. Requirement Confirmation: Validates goals and constraints before starting.
  2. Level Recommendation: Suggests a workflow level (L for manageable sequential work or XL for larger, parallelizable tasks).
  3. Skill Orchestration: Scans local folders and SKILL.md files to shortlist and assign the most appropriate skills to specific modules of the task.
  4. Execution & Recording: Coordinates the agent to execute the work, supporting TDD (Test-Driven Development) for code tasks and recording progress to allow session resumption.
  5. Verification: Compares actual outputs against the original plan to ensure all requirements are met before final acceptance.

Who it’s for

It is designed for users of AI harness frameworks (like Superpower or GSD) who maintain a large library of local skills and need an automated way to plan, route, and verify complex workflows.

Highlights

  • Intelligent Routing: Automatically selects the best-fitting skills from a library of 100+ candidates based on task needs.
  • Structured Workflows: Uses modular decomposition and state machines to organize work into groups and units.
  • Local Indexing: Minimizes token usage by performing discovery and shortlisting locally before reading full skill documents into the model context.
  • End-to-End Traceability: Maintains detailed records of requirements, plans, execution progress, and final acceptance reports.