# Academy Skill

Retrieve Binance Academy's official educational content (Glossary, Courses, Learn &...

- Repository: https://github.com/binance/binance-skills-hub (1115 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-26
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add binance/binance-skills-hub --skill academy-skill -g -a claude-code -y`
Codex: `npx skills add binance/binance-skills-hub --skill academy-skill -g -a codex -y`
Cursor: `npx skills add binance/binance-skills-hub --skill academy-skill -g -a cursor -y`
Gemini CLI: `npx skills add binance/binance-skills-hub --skill academy-skill -g -a gemini-cli -y`

## Description

Retrieve Binance Academy's official educational content (Glossary, Courses, Learn & Earn, Articles) for AI chat. Trigger when the user's message expresses one of these INTENTS (NOT keyword matches): (1) Knowledge Q&A, "What is Gas Fee?", "Why did I receive less crypto than I sent?", "How does staking work?" (2) Risk Education, high-risk trading/investment intent: leverage, borrowing to trade, all-in, scams, "20x long", "borrowing to amplify position" (3) Customized Learning Plan, "I want to learn DeFi", "Build me a 5-day Bitcoin plan", "DeFi learning path for beginners" (4) Learn & Earn, "Which Academy courses have rewards?", "一文读懂 X", "What is X (TICKER)?", "courses that pay crypto" This skill extracts clean query terms from natural language before calling the API. It NEVER gives investment advice, educational content only.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Binance Academy AI Skill

Intent-driven educational content skill. Retrieve Glossary / Courses /
Learn & Earn / Articles from Binance Academy, present as concise paraphrased
answers with Academy links. **Never investment advice.**

## When to Use

| Intent | Trigger examples | Primary tool |
|---|---|---|
| **1. Knowledge Q&A** | "What is X?", "Why does X happen?", "How does X work?" | `searchAll` (parallel) |
| **2. Risk Education** | leverage / borrowing / all-in / scams / "20x long" / "borrowing to trade" | `searchAll` + risk-warning block |
| **3. Learning Plan** | "I want to learn X", "X learning path", "build me a plan for X" | `getLearningPlan` |
| **4. Learn & Earn** | "Which courses have rewards?", "一文读懂 X", "What is X (TICKER)?" | `searchLearnEarn` or `searchAll` |

**Do NOT trigger for:** account/login issues, trading execution ("buy 1 BTC
now"), price checks ("what's BTC price"), or small talk.

For ambiguous intent cases (e.g., "什么是 X" vs "20x 杠杆是什么" vs "20x
杠杆可以吗"), see `references/intent-routing.md`.

## How to Use

### 1. Detect user language → `lang` code

Default: `zh` for Simplified Chinese, `en` for English. Full 35-code list
in `references/languages.md`.

### 2. Pick intent + call the script

All examples use `prod` (the only supported env). `ACADEMY_SKILL_DIR` =
this skill's root directory (resolved by the runtime when the skill loads).

```bash
# Intent 1, 2, Knowledge Q&A / Risk Education (parallel dispatch, recommended)
node "$ACADEMY_SKILL_DIR/scripts/academy-api.mjs" prod searchAll \
  '{"query":"gas fee","lang":"en","limit":3}'

# Intent 3, Learning Plan (use a clean topic noun, NOT the full sentence)
node "$ACADEMY_SKILL_DIR/scripts/academy-api.mjs" prod getLearningPlan \
  '{"query":"DeFi","lang":"en","limit":3}'

# Intent 4 Pattern A, explicit reward question
node "$ACADEMY_SKILL_DIR/scripts/academy-api.mjs" prod searchLearnEarn \
  '{"query":"reward","lang":"en","limit":5}'

The rest: https://github.com/binance/binance-skills-hub/blob/HEAD/skills/binance/academy-skill/SKILL.md