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:

1. Discover what capabilities exist
2. Know when to use each skill
3. 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:

text

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#

bash

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:

markdown

## 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.