javimosch Capability Awareness System
Makes OpenClaw agents aware of custom skills and capabilities. Skills-first approach with on-demand documentation loading. Zero overhead when not in use. Foundation for skill marketplace discovery.
When to use: Skill discovery, capability documentation, agent self-awareness of available tools
What to know:
Repository: https://github.com/pfaria32/openclaw-capability-awareness
Problem
Default OpenClaw agents don't know about custom skills you've installed. They need to:
- Discover what capabilities exist
- Know when to use each skill
- Access skill documentation on demand
Solution
Skills-First Approach:
- Agent sees skill descriptions in prompt
- Reads full SKILL.md when topic is relevant
- Zero overhead when skills not in use
- Simple, proven, low-risk
Implementation Options
Option 1: Skills-First (Recommended for v1)
Add capability cards to agent prompt:
Available Skills:
- token-economy: Model routing and cost optimization
- health-tracking: Apple Health and Strava integration
- memory-system: RAG-based semantic search
Agent reads full SKILL.md when needed.
Option 2: Full Injection (Advanced)
- Router-gated skill loading
- Dynamic prompt injection
- Context-aware capability exposure
- Zero baseline cost (only loads when relevant)
Installation
cd /home/node/.openclaw/workspace
git clone https://github.com/pfaria32/openclaw-capability-awareness.git projects/capability-awareness-system
Usage
Current Implementation (Skills-First)
Skills are documented in workspace/skills/*/SKILL.md. The agent loads these automatically through the AGENTS.md workflow:
## Skills (mandatory)
Before replying: scan <available_skills> <description> entries.
- If exactly one skill clearly applies: read its SKILL.md at <location> with `read`, then follow it.
This is already working! Just add new skills to the workspace/skills directory.
Future Implementation (Full Injection)
See repository for:
- Router design and schema
- Embedding-based skill matching
- Dynamic prompt injection strategy
- Cost/token analysis
Status
✅ Skills-First approach — Deployed and working 📋 Full Injection design — Documented, not yet implemented
Attribution
Built to support the emerging OpenClaw skill ecosystem. Simple beats clever.
Documentation
Implementation options, design decisions, and upgrade path documented in repository.