Capability Awareness System for Openclaw

An automated discovery system that allows agents to identify and load custom skill documentation on demand.

pfaria32
v1.0.3
Feb 14, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install capability-awareness

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install capability-awareness using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Capability Awareness System?

The Capability Awareness System solves the problem of agent ignorance regarding custom installations. By implementing a skills-first approach, it provides a structured way for agents to see high-level descriptions of available capabilities and only load full documentation when a specific task requires it. This architecture ensures that Openclaw Skills are always discoverable without cluttering the agent prompt with unnecessary technical details when they are not in use.

This system serves as the foundational layer for building a robust local ecosystem where agents can navigate complex workflows by pulling in the right tools at the right time. It bridges the gap between having a tool installed and having an agent that actually knows how and when to use it efficiently.

Capability Awareness System Use Cases

  • Enabling agents to self-discover new capabilities added to the workspace.
  • Optimizing token usage by loading documentation only for relevant Openclaw Skills.
  • Standardizing skill documentation formats across different development teams.
  • Providing a centralized registry for agent toolsets and capabilities.

How Capability Awareness System Works

  1. The agent is provided with a list of capability cards containing short summaries of available skills.
  2. When a user request is received, the agent scans these descriptions to see if any Openclaw Skills apply to the current context.
  3. If a match is identified, the agent executes a read command to access the full SKILL.md file located in the skill directory.
  4. The agent integrates the specific instructions from the documentation into its current reasoning chain.
  5. The agent executes the required actions based on the newly acquired skill knowledge.

Capability Awareness System Setup

To install the system, navigate to your workspace and clone the repository:

cd /home/node/.openclaw/workspace
git clone https://github.com/pfaria32/openclaw-capability-awareness.git projects/capability-awareness-system

Ensure that any new Openclaw Skills you develop are placed within the workspace/skills/ directory with a properly formatted SKILL.md file for the agent to read.

Capability Awareness System Data Schema & Taxonomy

Element Source Purpose
Skill Directory workspace/skills/* Root location for all installed capabilities
Metadata File SKILL.md Contains the logic, usage, and schema for individual Openclaw Skills
Registry Entry AGENTS.md Defines the workflow for how the agent discovers and scans skills
Capability Card Prompt Injection A brief summary used for initial discovery during the agent scan phase

Capability Awareness System Advanced Features

  • Skills-first approach for minimal prompt inflation and maximum efficiency.
  • On-demand documentation loading that preserves context window space.
  • Future-ready support for embedding-based skill matching and semantic search.
  • Router-gated skill loading for advanced multi-agent orchestration.
  • Dynamic prompt injection strategies for context-aware capability exposure.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*