# How to Import Skills into zhangxuefeng-skill: 3 Methods Explained > Learn how to import skills into zhangxuefeng-skill with 3 easy methods. Copy the repo, use the npx installer, or clone manually for efficient skill integration. - Repository: [花叔/zhangxuefeng-skill](https://github.com/alchaincyf/zhangxuefeng-skill) - Tags: how-to-guide - Published: 2026-06-27 --- **You can import zhangxuefeng-skill by copying the repository directory into your agent runtime's skills folder, using the one-line npx installer, or manually cloning the repository to the correct path.** The `zhangxuefeng-skill` repository by `alchaincyf` is an **Agent Skills package** that follows the open [Agent Skills protocol](https://agentskills.io). When you import skills into zhangxuefeng-skill, you enable AI agents to adopt Zhang Xuefeng's analytical framework for career and education consulting. The package is self-contained and requires no compilation or environment configuration once placed in the correct directory. ## Understanding the Package Structure Before importing, it helps to understand what the runtime expects to find. According to the source code layout, the `zhangxuefeng-skill` directory contains several key components: - **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)** - The core skill definition containing YAML front-matter that the runtime parses automatically - **[`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md)** - Human-readable documentation including installation instructions and usage overview - **`references/`** - Research data (such as [`references/research/05-decisions.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/references/research/05-decisions.md)) used to generate the skill's decision heuristics - **`examples/`** - Sample conversation logs (like [`examples/demo-conversation.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/examples/demo-conversation.md)) you can paste into prompts The runtime specifically looks for a file named [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) inside each subfolder of its skills directory. When found, it registers the skill under the folder name (`zhangxuefeng-skill`). ## Method 1: One-Line Auto-Installer (Recommended) The fastest way to import skills into zhangxuefeng-skill uses the official `npx` installer. This method automatically detects your current runtime and places the files in the correct location. ```bash npx skills add alchaincyf/zhangxuefeng-skill ``` This command fetches the repository from GitHub and installs it into the runtime-specific skills directory without manual path configuration. ## Method 2: Manual Git Clone For offline development or when you need to modify the skill locally, clone the repository directly into your runtime's skills folder. The specific path varies by agent runtime as documented in the repository's [`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md) [§ 安装](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md#%E5%AE%89%E8%A3%85): **For Claude Code:** ```bash git clone https://github.com/alchaincyf/zhangxuefeng-skill ~/.claude/skills/zhangxuefeng-skill/ ``` **For Codex:** ```bash git clone https://github.com/alchaincyf/zhangxuefeng-skill ~/.codex/skills/zhangxuefeng-skill/ ``` **For Cursor:** ```bash git clone https://github.com/alchaincyf/zhangxuefeng-skill ~/.cursor/skills/zhangxuefeng-skill/ ``` **For OpenClaw:** ```bash git clone https://github.com/alchaincyf/zhangxuefeng-skill ~/.openclaw/workspace/skills/zhangxuefeng-skill/ ``` These paths ensure the runtime discovers the [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) file automatically on startup. ## Method 3: Copy-Paste the Skill Definition If your runtime cannot load external skills automatically, manually import the skill definition by copying the contents of [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) into your prompt or a local file. The file is pure markdown, so no special tooling is required. After copying, you can invoke the skill using Chinese prompts like: ```text 用张雪峰的视角帮我分析这个专业选择 张雪峰会怎么看这个职业方向？ 切换到张雪峰，我孩子要填志愿了 ``` ## Verifying the Import Once imported using any method, the skill becomes immediately available. The runtime parses the skill definition from [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) and exposes Zhang Xuefeng's analytical capabilities without requiring additional configuration, environment variables, or compilation steps. You can verify successful import by confirming that [`references/research/05-decisions.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/references/research/05-decisions.md) is present in your local copy—this file contains the decision heuristics that shape the skill's responses. ## Summary - **zhangxuefeng-skill** is an Agent Skills package distributed as a self-contained directory with [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) at its root - The **one-line installer** (`npx skills add alchaincyf/zhangxuefeng-skill`) works across all supported runtimes and handles path detection automatically - **Manual installation** requires cloning to runtime-specific paths like `~/.claude/skills/` or `~/.cursor/skills/` depending on your agent - The **copy-paste method** works for offline or restricted environments by importing the raw [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) content directly - No configuration or dependencies are required after import; the runtime loads the skill automatically when it detects the [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) file ## Frequently Asked Questions ### What file does the runtime look for when importing zhangxuefeng-skill? The runtime searches for a file named **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)** inside each subfolder of the skills directory. This file contains the skill definition with YAML front-matter that the agent parses to register the capabilities. Without this file in the root of the `zhangxuefeng-skill` folder, the runtime will not recognize the package as a valid skill. ### Where should I clone the repository for Claude Code vs Cursor? For **Claude Code**, clone to `~/.claude/skills/zhangxuefeng-skill/`. For **Cursor**, use `~/.cursor/skills/zhangxuefeng-skill/`. The repository structure is identical across runtimes—only the parent directory path changes. The same applies to Codex (`~/.codex/skills/`) and OpenClaw (`~/.openclaw/workspace/skills/`), as implemented in `alchaincyf/zhangxuefeng-skill`. ### Do I need to configure environment variables after importing the skill? No. The **Agent Skills protocol** requires zero configuration after installation. Once the [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) file is present in the correct skills directory, the runtime loads it automatically on startup. There are no API keys, environment variables, or build steps required to activate zhangxuefeng-skill. ### Can I use zhangxuefeng-skill without an internet connection? Yes, if you use the **manual clone** or **copy-paste** methods. After the initial download, the skill operates entirely from local files. The `references/` directory and [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) contain all necessary data, allowing the agent to apply Zhang Xuefeng's analytical frameworks offline. Only the `npx` installer requires an active internet connection during installation.