← Back to Skills Marketplace
Agent Knowledge Capture
by
ianderrington
· GitHub ↗
· v1.0.0
1824
Downloads
1
Stars
10
Active Installs
1
Versions
Install in OpenClaw
/install agent-knowledge
Description
Unified knowledge capture and retrieval for URLs, video/article/paper extracts, social posts, and agent research outputs. Use when saving anything worth re-f...
README (SKILL.md)
Knowledge Skill
File-based knowledge organization. Capture fast, search later, clean up automatically.
Installation
clawhub install knowledge
This installs scripts/know — add to PATH or use full path:
~/.openclaw/skills/knowledge/scripts/know
Storage Location
Default: ~/.soulshare/agent/knowledge/
Configurable via ~/.config/know/config or env KNOWLEDGE_DIR.
knowledge/
├── INDEX.md # Auto-maintained browsable index
├── urls/ # Bookmarked URLs
├── extracts/ # Video/article/paper summaries
├── posts/ # Social content (tweets, threads)
└── research/ # Agent-generated research
Adding Content
know add url \x3Curl> --title "..." --tags "a,b" [--summary "..."]
know add video \x3Curl> --title "..." --tags "a,b" [--summary "..."]
know add extract --source \x3Curl> --type video|article|paper --title "..." --tags "a,b"
know add post --source \x3Curl> --title "..." --tags "a,b"
know add research --title "..." --tags "a,b" [--summary "..."]
Each add writes a markdown file with YAML frontmatter and updates INDEX.md.
Searching
know search "query" # Grep across all entries
know recent --limit 10 # Recent entries
know list --tags security # Filter by tag
Cleanup & Maintenance
know tidy # Audit: find issues
know tidy --fix # Auto-fix: normalize tags, move misplaced files, remove empty
know validate # Check frontmatter schema
know reindex # Rebuild INDEX.md
know config # Show active config paths
Recommended: Run know tidy --fix in heartbeats or nightly cron.
Data Model (frontmatter)
---
type: url|extract|post|research
title: "Entry title"
source_url: "https://..."
source_kind: url|video|article|paper|post|research
tags: ["tag1", "tag2"]
added: "2026-02-26"
added_by: "agent-name"
summary: "One-line summary"
---
QMD Integration
Plain markdown → QMD-indexable.
qmd collection add ~/.soulshare/agent/knowledge --name knowledge
qmd search "query" --collection knowledge
Discipline
- If it's useful later →
know addimmediately - Don't leave knowledge only in
memory/YYYY-MM-DD.md - Every entry needs tags + summary
- Let
know tidy --fixhandle normalization
Usage Guidance
This skill appears to document a local CLI for saving and maintaining notes, but the package contains only documentation and no executable or install spec. Before installing or enabling automation: 1) Confirm the origin — where does 'clawhub install knowledge' download from and is that source trustworthy (there's no homepage or source listed). 2) Verify the actual 'know' binary and inspect its code before running it, since the SKILL.md expects it to modify files under ~/.soulshare/agent/knowledge/ and run tidy --fix (which can remove or move files). 3) Back up your existing ~/.soulshare (and any target directories) before running auto-fix/cron tasks. 4) If you don't want automated modifications, avoid scheduling tidy --fix in heartbeats/cron and run maintenance manually after inspection. 5) Ask the publisher for the missing install manifest or source code; lack of code + install instructions is the main reason this is flagged as suspicious.
Capability Analysis
Type: OpenClaw Skill
Name: agent-knowledge
Version: 1.0.0
The `SKILL.md` describes a knowledge management skill that relies on an external script named `know` (located at `scripts/know`), which is not provided for analysis. The documentation mentions `know search` using `grep` for querying, which is a common pattern that can lead to shell injection vulnerabilities if the `know` script does not properly sanitize user input before executing `grep`. Without the `know` script, the full security posture cannot be assessed, but the described functionality presents a potential risk for command injection.
Capability Assessment
Purpose & Capability
Name/description (knowledge capture and retrieval) align with the instructions (commands to add/search/tidy knowledge entries). However the SKILL.md references an install command (clawhub install knowledge) and an on-disk script (~/.openclaw/skills/knowledge/scripts/know) even though the registry entry contains no install spec or code files. That gap is an incoherence to investigate.
Instruction Scope
Instructions stay within the stated domain: adding entries, searching, and maintaining a local knowledge directory. They explicitly write files under ~/.soulshare/agent/knowledge/ and read an optional config at ~/.config/know/config or env KNOWLEDGE_DIR, and recommend running tidy --fix periodically (which can move/remove files). Those file operations are expected for this purpose but are destructive by design (auto-fix/remove), so they should be reviewed before enabling automated runs.
Install Mechanism
The SKILL.md claims an installation step and a bundled script path, yet the skill package contains no install spec and no code files. Because there is no provided install mechanism or code, it's unclear where the 'know' binary comes from, what 'clawhub install knowledge' would fetch, or whether external downloads are required — this is an important inconsistency and a potential supply-chain risk if you try to follow the install instructions.
Credentials
No credentials or sensitive environment variables are requested. The only environment/config references are an optional KNOWLEDGE_DIR and a config file path, which are proportional to a local knowledge-management tool.
Persistence & Privilege
The skill does not request always-on privilege (always: false). It recommends running periodic maintenance (heartbeats/cron) which would allow automated modification/deletion of files; if enabled, that increases risk. The skill does not request access to other skills' configs or system-wide credentials.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-knowledge - After installation, invoke the skill by name or use
/agent-knowledge - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: file-based knowledge capture CLI for AI agents. Includes know add/search/tidy commands. Storage: ~/.soulshare/agent/knowledge/
Metadata
Frequently Asked Questions
What is Agent Knowledge Capture?
Unified knowledge capture and retrieval for URLs, video/article/paper extracts, social posts, and agent research outputs. Use when saving anything worth re-f... It is an AI Agent Skill for Claude Code / OpenClaw, with 1824 downloads so far.
How do I install Agent Knowledge Capture?
Run "/install agent-knowledge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Knowledge Capture free?
Yes, Agent Knowledge Capture is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Agent Knowledge Capture support?
Agent Knowledge Capture is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Knowledge Capture?
It is built and maintained by ianderrington (@ianderrington); the current version is v1.0.0.
More Skills