← Back to Skills Marketplace
Skill Preflight
by
thekhemistai
· GitHub ↗
· v1.0.5
· MIT-0
115
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install skill-preflight
Description
Automatically inject relevant skills and protocols into agent context using local embeddings. Free, no API calls — uses Ollama with nomic-embed-text.
Usage Guidance
This plugin is internally consistent and implements what it claims, but review these before enabling: (1) Keep ollamaBaseUrl set to localhost/127.0.0.1/::1 unless you trust the remote host — otherwise your prompts and all indexed docs (including any embedded secrets or API keys in markdown) will be transmitted off-host. (2) Audit your skills/ memory/protocol markdown and remove any secrets or credentials before allowing the plugin to index them, or restrict protocolDirs/skillsDirs to safe paths. (3) Because the repository source is 'unknown' in the metadata provided, review the dist/index.js (full file) yourself or run the plugin in a sandbox to confirm behavior matches expectations. (4) Tune minScore, maxDocLines, and pinnedDocs to reduce accidental injection of large or sensitive docs. (5) If you need higher assurance, run Ollama locally and validate network traffic to ensure embeddings never leave your machine.
Capability Analysis
Type: OpenClaw Skill
Name: skill-preflight
Version: 1.0.5
The plugin implements a RAG (Retrieval-Augmented Generation) system that reads local markdown files from the workspace and sends their content, along with user prompts, to a configurable Ollama API endpoint for embedding (dist/index.js). While the documentation (README.md) and the code itself include explicit warnings and runtime logs regarding the privacy risks of using a non-local 'ollamaBaseUrl', the capability to read arbitrary files and transmit them to a network endpoint constitutes a high-risk behavior that could be leveraged for data exfiltration if misconfigured.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, package.json, and dist/index.js all describe and implement the same feature: local scanning of skills/protocols, embedding via nomic-embed-text through an Ollama HTTP API, ranking by cosine similarity, and injecting top matches. There are no unrelated credential or binary requirements.
Instruction Scope
Instructions and implementation explicitly read markdown files from configured workspace directories (skills/, memory/protocols/, tools files, pinned docs) and embed both the incoming prompt and full document text. That behavior is expected for the stated purpose, but it means any secrets or credentials embedded in your docs will be read and (depending on configuration) transmitted for embedding.
Install Mechanism
No external install script or remote downloads are included in the plugin bundle. The only external runtime dependency is Ollama and the local embedding model (which the SKILL.md instructs you to pull). No arbitrary URL downloads or archive extraction are present in the provided files.
Credentials
The plugin declares no required environment variables or credentials and the code doesn't request unrelated secrets. The main configuration risk is the ollamaBaseUrl: if set to a remote host, prompt text and indexed docs (including any secrets in them) will be sent to that host. The code and docs clearly warn about this trust-boundary change.
Persistence & Privilege
The skill is not force-enabled (always: false), doesn't request elevated privileges, and appears to only operate within its own configured scope (workspace doc dirs and its session caches). It does not modify other skills' configurations per the provided files.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skill-preflight - After installation, invoke the skill by name or use
/skill-preflight - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
Fix doc mismatches, strengthen remote Ollama trust-boundary warnings, and remove remaining gold-standard-specific skip behavior.
v1.0.4
Replace setup-specific skipped filenames with generic audit/eval filtering patterns.
v1.0.3
Remove stray internal truth-gate script from repository.
v1.0.2
Clarify privacy boundary for ollamaBaseUrl and warn when configured to a remote host.
v1.0.1
Cleanup release: removed internal docs from published package.
v1.0.0
Initial release: local-embedding skill and protocol injection for OpenClaw.
Metadata
Frequently Asked Questions
What is Skill Preflight?
Automatically inject relevant skills and protocols into agent context using local embeddings. Free, no API calls — uses Ollama with nomic-embed-text. It is an AI Agent Skill for Claude Code / OpenClaw, with 115 downloads so far.
How do I install Skill Preflight?
Run "/install skill-preflight" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skill Preflight free?
Yes, Skill Preflight is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Skill Preflight support?
Skill Preflight is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skill Preflight?
It is built and maintained by thekhemistai (@thekhemistai); the current version is v1.0.5.
More Skills