NarraNexus · Modules
Skills Module
Manages user-installed skills in the workspace. Discovers skills, tracks configuration, stores study summaries, and provides tools for skill setup — all filesystem-based, no database required.
How Skills Work
Skills are self-contained capability packages installed in the agent's workspace. Each skill lives in its own directory under skills/.
DiscoveryScans the skills/ directory, parses SKILL.md frontmatter for metadata, detects required env vars
ConfigurationTracks required credentials per skill. The agent uses skill_list_required_env to check what’s needed, then skill_save_config to register each credential. Status shows as needs (missing) or ready.
StudyAgent reads SKILL.md, registers credentials, and saves a structured study summary via skill_save_study_summary
RuntimeConfigured env vars are injected at runtime. Skills table with status displayed in agent instructions.
Installation Methods
From ClawHubclawhub install <slug> --dir skills/ --force --no-input
From GitHub/URLClone or download to skills/<skill-name>/
After installation, the agent follows a study protocol: read SKILL.md, register credentials, save summary, and report readiness.
Workspace Rules
Skills enforce strict workspace isolation:
- All files created/downloaded go into skills/<skill-name>/
- Credentials stored locally AND registered via skill_save_config
- System-level tools (pip install) are the only exception to workspace containment
- Relative paths used in prompts to avoid path duplication
Tools
skill_save_configSave credential/env var for a skillskill_list_required_envQuery required env vars and their configuration statusskill_save_study_summarySave structured Markdown study documentation