How foryourhealth111-pixel/vibe-skills works
VibeSkills is a local-Skill discovery and workflow-orchestration product, exposed through a CLI and installed into supported host environments. Its central workflow is to interpret a task, find and select relevant installed Skills, plan dependent work, execute it, and verify deliverables. The graph also shows installation and shared contracts. The README documents the user-facing workflow and capabilities; source-level edges are limited to relationships visible in excerpts or SOURCE INDEX references, so some documented but unsampled subsystems have no internal call links.
Main entry points: loop.py Workflow Loop · skill_index.py Skill Index · main.py VibeSkills CLI · commands.py CLI Commands
Components 19
User Entry
- VibeSkills CLI
apps/vgo-cli/src/vgo_cli/main.py - CLI Commands
apps/vgo-cli/src/vgo_cli/commands.py - Canonical Entry
packages/runtime-core/src/vgo_runtime/canonical_entry.py
Skill Routing
- Task Router
packages/runtime-core/src/vgo_runtime/router_contract_runtime.py - Skill Index
packages/runtime-core/src/vgo_runtime/kernel/skill_index.py - Host Skill Roots
packages/runtime-core/src/vgo_runtime/kernel/host_skill_roots.py - Capability Bridge
packages/runtime-core/src/vgo_runtime/kernel/capability_bridge.py
Workflow Runtime
- Workflow Loop
packages/runtime-core/src/vgo_runtime/kernel/loop.py - Work Planner
packages/runtime-core/src/vgo_runtime/kernel/planner.py - Work Executor
packages/runtime-core/src/vgo_runtime/kernel/executor.py - Deliverable Verifier
packages/runtime-core/src/vgo_runtime/kernel/verifier.py - Artifact Contract
packages/runtime-core/src/vgo_runtime/artifact_contract.py - Bundled Skills
bundled/skills
Host Installation
- Installer Runtime
packages/installer-core/src/vgo_installer/install_runtime.py - Adapter Registry
packages/installer-core/src/vgo_installer/adapter_registry.py - Uninstall Service
packages/installer-core/src/vgo_installer/uninstall_service.py
Shared Contracts
- Host and Target Contracts
packages/contracts/src/vgo_contracts/canonical_vibe_contract.py
Other components
- User
- Host Environment
Connections 18
- User → VibeSkills CLI: invokes
README.md - VibeSkills CLI → CLI Commands: dispatches
apps/vgo-cli/src/vgo_cli/main.py - CLI Commands → Canonical Entry: launches workflow
- Canonical Entry → Workflow Loop: invokes
packages/runtime-core/src/vgo_runtime/canonical_entry.py - Workflow Loop → Work Planner: uses
packages/runtime-core/src/vgo_runtime/kernel/loop.py - Workflow Loop → Work Executor: uses
packages/runtime-core/src/vgo_runtime/kernel/loop.py - Workflow Loop → Deliverable Verifier: uses
packages/runtime-core/src/vgo_runtime/kernel/loop.py - Workflow Loop → Skill Index: uses
packages/runtime-core/src/vgo_runtime/kernel/loop.py - Workflow Loop → Host Skill Roots: uses
packages/runtime-core/src/vgo_runtime/kernel/loop.py - Workflow Loop → Artifact Contract: uses
packages/runtime-core/src/vgo_runtime/kernel/loop.py - Task Router → Skill Index: uses
packages/runtime-core/src/vgo_runtime/router_contract_runtime.py - Skill Index → Capability Bridge: uses
packages/runtime-core/src/vgo_runtime/kernel/skill_index.py - Skill Index → Host Skill Roots: uses
packages/runtime-core/src/vgo_runtime/kernel/skill_index.py - User → Installer Runtime: requests installation
README.md - Installer Runtime → Host Environment: installs into
README.md - Uninstall Service → Adapter Registry: loads
packages/installer-core/src/vgo_installer/uninstall_service.py - Adapter Registry → Host and Target Contracts: uses shared definitions
packages/installer-core/src/vgo_installer/adapter_registry.py - User → Host Environment: uses Skills
README.md