# AI Runtimes Compatible with Zhangxuefeng-Skill: Complete Guide

> Discover AI runtimes compatible with Zhangxuefeng-skill. Explore Claude Code, Codex CLI, Cursor, OpenClaw, Hermes Agent, and more with automatic detection.

- Repository: [花叔/zhangxuefeng-skill](https://github.com/alchaincyf/zhangxuefeng-skill)
- Tags: getting-started
- Published: 2026-06-12

---

**Zhangxuefeng-skill runs on any AI-agent runtime implementing the Agent Skills protocol, including Claude Code, Codex CLI, Cursor, OpenClaw, and Hermes Agent, with automatic runtime detection via the npx installer.**

The **zhangxuefeng-skill** repository by alchaincyf implements the open Agent Skills protocol, enabling broad compatibility across modern AI agent runtimes. This skill packages the Zhangxuefeng persona into a self-contained format that requires no language-specific dependencies or runtime-specific code modifications. Understanding which AI runtimes are compatible with Zhangxuefeng-skill helps developers deploy the persona consistently across different AI coding environments.

## Supported AI Runtimes

The repository explicitly lists several runtimes that work out-of-the-box. According to the [`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md) installation section, the following paths are used when manually installing:

- **Claude Code**: `~/.claude/skills/zhangxuefeng-skill/`
- **Codex CLI**: `~/.codex/skills/zhangxuefeng-skill/`
- **Cursor**: `~/.cursor/skills/zhangxuefeng-skill/`
- **OpenClaw**: `~/.openclaw/workspace/skills/zhangxuefeng-skill/`
- **Hermes Agent**: Install via the install script or clone into the agent's `skills` folder

The generic installer supports 50+ additional runtimes through automatic detection.

## How Compatibility Works Under the Hood

### The Agent Skills Protocol

The skill is built on the **Agent Skills** protocol, a lightweight, language-agnostic contract specifying how skill metadata and assets are discovered, loaded, and invoked. This protocol ensures that any runtime implementing the interface can execute the skill without modification.

### Runtime Detection Mechanism

The one-line installer (`npx skills add alchaincyf/zhangxuefeng-skill`) ships a detection script that queries the environment for known runtime signatures. It checks for directories like `~/.claude/`, `~/.codex/`, or `~/.cursor/` to determine the correct installation path automatically.

### Uniform Entry Point

Every supported runtime reads the same **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)** file containing the YAML front-matter and markdown content. This file serves as the universal entry point, ensuring forward compatibility with future runtimes that adopt the Agent Skills specification.

## Installation Methods

### One-Line Auto-Detection Installation

The simplest method uses the npx installer to automatically detect your runtime and place the skill in the correct directory:

```bash
npx skills add alchaincyf/zhangxuefeng-skill

```

This command copies [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) to the appropriate location based on detected runtime signatures.

### Manual Installation for Specific Runtimes

For manual installation, clone the repository into the runtime-specific skills directory. For Claude Code:

```bash
git clone https://github.com/alchaincyf/zhangxuefeng-skill \
  ~/.claude/skills/zhangxuefeng-skill

```

Replace the target path with the appropriate directory for your runtime (see the supported paths listed above).

### Using the Skill

Once installed, invoke the skill through any compatible agent:

```text
用张雪峰的视角帮我分析这个专业选择

```

The runtime parses [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) and routes the prompt to the Zhangxuefeng persona.

## Summary

- **Zhangxuefeng-skill** supports any AI runtime implementing the Agent Skills protocol
- Explicitly tested runtimes include Claude Code, Codex CLI, Cursor, OpenClaw, and Hermes Agent
- The **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)** file provides the universal entry point for all compatible runtimes
- Automatic installation via `npx skills add` detects the runtime environment and handles path configuration
- Manual installation requires cloning into runtime-specific directories like `~/.claude/skills/` or `~/.codex/skills/`

## Frequently Asked Questions

### What makes Zhangxuefeng-skill runtime-agnostic?

The skill contains **no binary or language-specific dependencies**. It relies solely on the [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) file format defined by the Agent Skills protocol, which any runtime can parse to load the persona.

### Can I use Zhangxuefeng-skill with future AI runtimes?

Yes. Any runtime implementing the Agent Skills interface (such as Gemini CLI, Workbuddy, or OpenCode) will be compatible without requiring changes to the repository, as the [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) format remains the uniform entry point.

### Where does the installer place the skill files?

The installer detects your runtime and copies [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) to the appropriate subdirectory—typically `~/.claude/skills/`, `~/.codex/skills/`, `~/.cursor/skills/`, or `~/.openclaw/workspace/skills/` depending on your environment.

### Is there runtime-specific code in the repository?

No. The repository contains no runtime-specific code. All logic resides in the [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) file, which follows the standardized Agent Skills specification, ensuring consistent behavior across all supported AI runtimes.