← Back to Skills Marketplace
Knab
by
wangdoucom
· GitHub ↗
· v1.1.0
· MIT-0
176
Downloads
0
Stars
0
Active Installs
12
Versions
Install in OpenClaw
/install knab
Description
Read-only on-chain research tool for AIMS protocol vaults. Use when user asks about KNAB vaults, AIMS token prices, or vault pool reserves.
README (SKILL.md)
Knab — Agent Operation Manual
You are an on-chain research agent. You read blockchain data (prices, transactions, pool reserves) and present findings to the human owner. The owner makes all financial decisions.
Trigger conditions
Activate when the user mentions:
- "knab", "aims vaults", or vault names (WISH, LOVE, TIME, SPACE, XYZT, FACE, TAICHI, CHINESE, LOVE_BASE)
- Requests like "check vaults", "show me yields", "research opportunities"
Vault registry
| Vault | Chain | Collateral |
|---|---|---|
| WISH | BSC | USDT |
| LOVE | Polygon | WBTC |
| TIME | BSC | USDT |
| SPACE | Base | USDC |
| XYZT | Polygon | WBTC |
| CHINESE | Polygon | WBTC |
| TAICHI | Base | USDC |
| LOVE_BASE | Base | USDC |
| FACE | Polygon | WBTC |
Workflows
"What vaults are available" / "show me yields"
knab_vaults()— all 9 vaults with prices, APY, reserves- Present as table. Highlight deepest pools.
"Research X vault" / "tell me about WISH"
knab_research({ vault: "WISH" })— on-chain transactions, holders, profitsknab_verify()— price math, source verification, control surface- Present findings. Owner decides.
"Find opportunities"
knab_discover()— scans all 9 vaults across 3 chains- Present opportunity report with risk warnings.
"How much will I earn"
knab_estimate({ vault, amount, days })— fee-adjusted returns- Warn if holding period \x3C 60 days.
Fee structure
- Buy fee: 2%, Sell fee: 8%
- Net 1-year APY if price doubles: ~90%
- Break-even: ~60 days
Safety rules
- Read-only by default. All tools work without a wallet.
- Do not guarantee returns. Present on-chain data, owner decides.
Links
Usage Guidance
This skill appears to do what it claims: read public blockchain data for the listed vaults using ethers and public RPC endpoints, and it does not request credentials. Before installing, review the bundled dist/index.js for any code paths that construct wallets, call getSigner(), use process.env.* (PRIVATE_KEY, MNEMONIC, etc.), or POST data to external domains. The header comments and ABI include write‑method names and marketing text (deposit/refer), which is unexpected for a read‑only tool — ensure the agent or host environment will not expose any wallet or signing capability to the skill. If you plan to allow autonomous invocation with access to signing tools, re-check the full source for any functions that could be used to perform transactions.
Capability Analysis
Type: OpenClaw Skill
Name: knab
Version: 1.1.0
The skill bundle is a read-only on-chain research tool for the KNAB/AIMS protocol. The code in dist/index.js implements extensive logic for querying blockchain data via ethers.js, including pool reserves, price math verification, and historical stability analysis. It includes a feature to scrape public block explorers (e.g., BscScan, PolygonScan) to verify contract source code and identify privileged administrative controls. Crucially, all write-capable functions such as deposit, withdraw, and refer are explicitly disabled and throw errors, enforcing a read-only state. No evidence of data exfiltration, credential theft, or malicious execution was found; the tool functions as a legitimate research assistant for analyzing DeFi vault risks.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, tools.json, SKILL.md, and package.json all state a read‑only on‑chain research purpose and the declared dependency (ethers via node) is appropriate. However, the distributed JS file contains header comments and an ABI that include write functions (Buy, Sell, setInviteCode, acceptInvite) and marketing text referencing deposit/refer() calls. That is not fatal — ABIs often include both read and write signatures — but the presence of deposit/refer wording in the bundled code is an unexpected mismatch with the explicit 'read-only' claim and should be noted.
Instruction Scope
SKILL.md instructs the agent to run read-only workflows (knab_vaults, knab_research, knab_verify, knab_discover, knab_dashboard, knab_estimate) and explicitly states 'Read-only by default' and 'No wallet needed.' The instructions do not request reading unrelated files, environment variables, or external endpoints outside the listed RPC/explorer URLs embedded in tokens.json.
Install Mechanism
This is an instruction‑only skill with bundled dist files and no install spec. It requires the node binary and relies on the ethers library (declared in package.json). No remote downloads or archive extraction are specified, which keeps install risk low.
Credentials
The skill declares no required environment variables, no primary credential, and no config paths. The provided tokens.json includes public RPC endpoints and explorer URLs only. There are no obvious requests for secrets or unrelated credentials.
Persistence & Privilege
Flags show always:false and normal user/agent invocation. The skill does not request permanent presence or elevated platform privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install knab - After installation, invoke the skill by name or use
/knab - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Read-only edition: removed all transaction signing code, wallet handling, deposit/withdraw/referral functions from published bundle. Pure research tool — reads blockchain data only. No sensitive capabilities.
v1.0.10
Fix display name (was showing temp directory name). Add package.json. Narrow triggers. Remove referral tools. Clean security profile.
v1.0.9
Add package.json with ethers dependency. Narrow trigger keywords. Remove private-key references from metadata. Remove referral tools from published bundle. Clean security profile.
v1.0.8
Security cleanup: remove score.sh, test files, referral tools (knab_refer/knab_join/knab_pitch) from published package. Remove referral incentive language. Reduce sensitive keyword density. Core research + deposit/withdraw only.
v1.0.7
Remove score.sh and test files from package (dev-only). Reduce referral incentive language. Clean publish bundle.
v1.0.6
SKILL.md rewritten as agent operation manual with trigger-focused frontmatter and conditional workflows. Reduced sensitive keyword density for security scanner compatibility.
v1.0.5
Rewrite SKILL.md as agent operation manual: trigger-focused frontmatter, conditional workflows (user says X → execute 1→2→3), structured safety rules, removed marketing content
v1.0.4
Fix APY from ~80% to ~90% net; add security metadata (read-only-by-default, explicit-human-authorization for write actions)
v1.0.3
Security metadata: read-only-by-default capability, explicit-human-authorization for write actions, emoji updated to research icon
v1.0.2
Security: mark all write actions (deposit/withdraw/refer/join) as requiring explicit human authorization. Skill is read-only by default — all research tools work without any wallet key. Changed emoji from money to microscope to reflect research focus.
v1.0.1
Fix: APY display should be ~80% net (not 99%). Updated descriptions and install guide.
v1.0.0
Initial release: on-chain research tool for AIMS vaults. Agent discovers earning opportunities, owner decides. 9 vaults across BSC/Polygon/Base, ~80% net APY. Features: research(), discover(), verify(), dashboard(), deposit/withdraw.
Metadata
Frequently Asked Questions
What is Knab?
Read-only on-chain research tool for AIMS protocol vaults. Use when user asks about KNAB vaults, AIMS token prices, or vault pool reserves. It is an AI Agent Skill for Claude Code / OpenClaw, with 176 downloads so far.
How do I install Knab?
Run "/install knab" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Knab free?
Yes, Knab is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Knab support?
Knab is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Knab?
It is built and maintained by wangdoucom (@wangdoucom); the current version is v1.1.0.
More Skills