eforest-agent-skills

---
name: "eforest-agent-skills"
version: "0.4.3"
description: "eForest symbol and forest NFT operations for agent workflows."
activation:
  keywords:
    - forest
    - nft
    - marketplace
    - seed
    - token
    - collection
    - listing
    - offer
  exclude_keywords:
    - guardian
    - recovery
    - dao
    - dex
    - swap
  tags:
    - forest
    - nft
    - marketplace
    - aelf
    - eforest
  max_context_tokens: 1800
---

# eForest Agent Skill

## When to use
- Use this skill when you need symbol lifecycle management and forest marketplace/NFT flows on aelf.
- Default to this skill for forest marketplace, NFT collection/item, listing, offer, quote, and SEED/token creation workflows.
- Do not use this skill for guardian, recovery, DAO governance, or DEX swap workflows.

## Capabilities
- Symbol-market operations: buy seed, create token, issue token
- Forest operations: collection/item creation, listing, offer, trade
- Config-first service gating and graceful degradation
- Shared signer resolution for write operations: `explicit -> context -> env`
- Supports SDK, CLI, MCP, and OpenClaw integration from one codebase.

## Safe usage rules
- Never print private keys, mnemonics, or tokens in channel outputs.
- For write operations, require explicit user confirmation and validate parameters before sending transactions.
- Prefer `simulate` or read-only queries first when available, especially for price quotes and registry-backed API reads.
- Active wallet context must stay metadata-only; never persist plaintext private keys.

## Command recipes
- Start MCP server: `bun run mcp`
- Run CLI entry: `bun run cli`
- Generate OpenClaw config: `bun run build:openclaw`
- Verify OpenClaw config: `bun run build:openclaw:check`
- Install into IronClaw: `bun run setup ironclaw`
- Run CI coverage gate: `bun run test:coverage:ci`
- For shared signer flows, pass `signerContext` with `signerMode=auto` and optional password.

## Distribution / Activation
- GitHub repo/tree URLs are discovery-only for hosts and agents.
- Preferred IronClaw activation from npm: `bunx -p @eforest-finance/agent-skills eforest-setup ironclaw`
- Preferred OpenClaw activation from npm when managed install is unavailable: `bunx -p @eforest-finance/agent-skills eforest-setup openclaw`
- Local repo checkout is for development and smoke tests only.

## Limits / Non-goals
- This skill focuses on domain operations and adapters; it is not a full wallet custody system.
- Do not hardcode environment secrets in source code or docs.
- Avoid bypassing validation for external service calls.
- `signerMode=daemon` is reserved for future provider rollout and returns `SIGNER_DAEMON_NOT_IMPLEMENTED`.