中文 | English

aelf Skills

A single discovery and bootstrap entry for the aelf skill ecosystem.

This repository provides:

1. Bilingual entry docs for humans and AI agents.
2. A machine-readable catalog: skills-catalog.json.
3. One-click bootstrap: bootstrap.sh.

AI Quick Prompt (OpenClaw / Codex / Cursor / Claude Code)

Repository: https://github.com/AElfProject/aelf-skills
This is a client-agnostic prompt for OpenClaw, Codex, Cursor, and Claude Code.
Read first: skills-catalog.json, docs/SKILL_ROUTING_MATRIX.md, docs/AI_E2E_SCENARIOS.md.
Then run:
1) ./bootstrap.sh --source github --dest ./downloaded-skills
2) bun run health:check -- --skills-root ./downloaded-skills
3) read `clientInstall.openclaw` / `clientInstall.ironclaw` from `skills-catalog.json`; if `installCommand` exists, execute it locally instead of treating a GitHub tree URL as the final install input
Routing rule: follow SKILL_ROUTING_MATRIX; if ambiguous, output Recommended/Alternative/Reason.
Failure rule: use Common Recovery Template in docs/AI_E2E_SCENARIOS.md.

Scope

This hub focuses on discovery, download, install, and capability indexing.

It does not replace each skill repository's own client integration logic. Client-specific setup (OpenClaw, Cursor, Claude Desktop, IronClaw, Codex, Claude Code) remains inside each skill repo. AI agents: jump to AI Navigation for routing and execution guides.

Discovery vs Activation

Treat skill distribution in two stages:

1. discovery: GitHub repo URL / npm package / ClawHub slug help the host find the skill.
2. activation: the host or agent executes the machine-readable install contract from skills-catalog.json.

Rules:

1. GitHub tree/repo URLs are discovery sources only. Do not treat them as the final IronClaw install artifact.
2. For IronClaw, prefer clientInstall.ironclaw.installCommand and expect a trusted local install step.
3. For OpenClaw, prefer ClawHub / managed install when distributionSources.clawhubId exists; otherwise use clientInstall.openclaw.installCommand.

Prerequisites

• bun >= 1.1.0 (hard requirement)
• npm >= 10
• git >= 2.39
• tar (GNU tar / bsdtar)

Local Environment Setup

workspace.json paths use ${SKILLS_BASE} placeholders for portability. workspace.json is Codex-local workspace config; external consumers should use skills-catalog.json as the data source.

export SKILLS_BASE=/path/to/your/workspace

Example:

• ${SKILLS_BASE}/AElf/aelf-node-skill
• ${SKILLS_BASE}/awaken/awaken-agent-skills

Install

npm install @blockchain-forever/aelf-skills
# or
bun add @blockchain-forever/aelf-skills

Quick Start

# 1) Generate public catalog and sync README tables
bun run catalog:generate

# 2) Generate local catalog with sourcePath (for local bootstrap/health)
bun run catalog:generate:local

# 3) Run baseline gates
bun run health:check
bun run readme:check
bun run security:audit

# 4) Bootstrap selected skills
./bootstrap.sh --only aelf-node-skill --skip-install

# 5) Check hub/catalog update drift (non-blocking)
bun run update:check

Bootstrap CLI

./bootstrap.sh [--catalog ] [--dest <dir>] [--source auto|npm|github|local] [--skip-install] [--skip-health] [--only <csv>]

Defaults:

1. --source auto (npm first, fallback to github)
2. install enabled
3. health check enabled
4. skills-catalog.json as catalog source