← Back to Skills Marketplace
779
Downloads
2
Stars
4
Active Installs
2
Versions
Install in OpenClaw
/install explain
Description
Learns how to explain things to your human. Adapts format, depth, and style by topic.
README (SKILL.md)
Adaptive Explanation Preferences
Scope: Human-facing explanations only. Track what lands and what misses.
Quick Reference
| File | Purpose |
|---|---|
formats.md |
When bullets/prose/headers work or fail |
depth.md |
Calibrating detail level by signals |
analogies.md |
When comparisons help vs hurt |
domains.md |
Patterns for code, concepts, debugging, decisions |
dimensions.md |
Full list of trackable dimensions |
Core Loop
- Observe — Notice when explanations work vs confuse
- Signal — "Got it" = worked. Follow-ups / "wait what?" = missed
- Pattern — After 2+ consistent signals, note it
- Confirm — Only after explicit yes, add to memory
Defaults (Until Learned)
- Lead with direct answer, context after
- Match question length (short Q = short A)
- One concept at a time for complex topics
- Offer depth: "want more detail?" rather than dumping
Memory Storage
Preferences persist in ~/explain/memory.md. Create on first use:
## Format
\x3C!-- Format: "topic: preference (level)" -->
\x3C!-- Ex: code: bullets (confirmed), concepts: prose (pattern) -->
## Depth
\x3C!-- Format: "topic: depth (level)" -->
\x3C!-- Ex: React: deep (confirmed), Git: tldr (pattern) -->
## Examples
\x3C!-- Format: "topic: example-style (level)" -->
\x3C!-- Ex: SQL: always examples (confirmed), theory: minimal (pattern) -->
## Jargon
\x3C!-- Format: "domain: jargon-level (level)" -->
\x3C!-- Ex: programming: full jargon (confirmed), finance: simplify (pattern) -->
## Never
\x3C!-- Approaches that fail. Format: "approach (level)" -->
\x3C!-- Ex: walls of text (confirmed), over-analogizing (pattern) -->
Levels: pattern (2+ signals) → confirmed (explicit yes) → locked (reinforced)
Usage Guidance
This skill appears coherent and low-risk: it only contains guidance for adapting explanations and stores a local preference file at ~/explain/memory.md. Before installing, consider whether you are comfortable with the agent writing a small file to your home directory; you can inspect or delete that file at any time. If you have strict data controls, verify your platform's file-write policies for skills; otherwise this skill does not request credentials, network endpoints, or other sensitive access.
Capability Analysis
Type: OpenClaw Skill
Name: explain
Version: 1.0.2
The OpenClaw skill bundle 'Explain' is designed to help an AI agent learn and adapt its explanation style. The `SKILL.md` file instructs the agent to persist learned preferences in `~/explain/memory.md`. This file write operation is specific, targets a non-sensitive location within the user's home directory, and is directly aligned with the skill's stated purpose of adaptive learning. All other `.md` files provide guidance and heuristics for the agent's explanation process. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts designed to subvert the agent's core function or access sensitive data.
Capability Assessment
Purpose & Capability
Name/description (adaptive explanation) match the content: guidance files and runtime SKILL.md all focus on formatting, depth, domains, and tracking preferences. No unrelated capabilities, binaries, or credentials are requested.
Instruction Scope
Runtime instructions are limited to observing user signals, adapting behavior, and optionally persisting confirmed preferences. They do not direct the agent to read other system files, network endpoints, or unrelated environment variables.
Install Mechanism
No install spec and no code files to execute; this is instruction-only, so nothing will be downloaded or installed on disk beyond the explicit memory file the skill asks to create.
Credentials
The skill declares no required env vars, credentials, or config paths. It does ask to create and maintain a single local file (~/explain/memory.md) which is proportional to the personalization purpose.
Persistence & Privilege
The skill persists preferences to ~/explain/memory.md and will create that file on first use. This is reasonable for a personalization skill, but it does create local state that may contain user-specific preferences. It is not set to always:true and does not request elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install explain - After installation, invoke the skill by name or use
/explain - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Restructured with auxiliary files; added Quick Reference
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Explain?
Learns how to explain things to your human. Adapts format, depth, and style by topic. It is an AI Agent Skill for Claude Code / OpenClaw, with 779 downloads so far.
How do I install Explain?
Run "/install explain" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Explain free?
Yes, Explain is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Explain support?
Explain is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Explain?
It is built and maintained by Iván (@ivangdavila); the current version is v1.0.2.
More Skills