# Where to Find zhangxuefeng-skill Documentation: Complete Guide to Source Files and Installation

> Find comprehensive zhangxuefeng-skill documentation, source files, and installation guides within the alchaincyf/zhangxuefeng-skill repository. Get started easily.

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

---

**The complete zhangxuefeng-skill documentation is located in the repository's [`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md), [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md), [`examples/demo-conversation.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/examples/demo-conversation.md), and the `references/research/` directory containing six primary source files.**

The **alchaincyf/zhangxuefeng-skill** repository houses all documentation required to understand, install, and deploy the skill. This comprehensive guide maps every documentation file and explains how to access the machine-readable specifications and research materials that power the Zhang Xuefeng role-play implementation.

## Core Documentation Files

The documentation is distributed across four key locations, each serving a distinct purpose in the skill ecosystem.

### README.md

The **[`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md)** file in the repository root provides the high-level project description, installation commands, and quick-start usage examples. It documents three installation methods—one-line CLI, manual clone, and reference-only usage—and outlines the key mental models extracted from the research materials.

### SKILL.md

The **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)** file contains the full **skill definition** including YAML front-matter, role-play rules, answer workflow, and expressive DNA. This is the machine-readable specification that the Agent Skills runtime consumes to instantiate the Zhang Xuefeng persona. It defines the deterministic language patterns and data-first workflow that govern the skill's responses.

### examples/demo-conversation.md

The **[`examples/demo-conversation.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/examples/demo-conversation.md)** file provides a complete end-to-end conversation demonstrating the skill in action. This real-world dialogue example serves as both a testing reference and a copy-paste template for users implementing the skill in their own runtimes.

### references/research/

The **`references/research/`** directory contains six Markdown files that constitute the primary source material distilled into the skill:

- **[`01-writings.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/01-writings.md)** – Books and written works
- **[`02-conversations.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/02-conversations.md)** – Interviews and talks
- **[`03-expression-dna.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/03-expression-dna.md)** – Stylistic and expressive DNA
- **[`04-external-views.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/04-external-views.md)** – External critiques and analyses
- **[`05-decisions.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/05-decisions.md)** – Major life and career decisions
- **[`06-timeline.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/06-timeline.md)** – Chronological life timeline

## Repository Structure

The documentation follows this organizational hierarchy:

```

zhangxuefeng-skill/
├─ README.md                # Intro, install commands, overview

├─ SKILL.md                 # Skill definition, role-play rules, models

├─ references/
│  └─ research/
│     ├─ 01-writings.md
│     ├─ 02-conversations.md
│     ├─ 03-expression-dna.md
│     ├─ 04-external-views.md
│     ├─ 05-decisions.md
│     └─ 06-timeline.md
└─ examples/
   └─ demo-conversation.md # Sample dialogue

```

## Installation Methods

The documentation outlines three primary methods for installing zhangxuefeng-skill in an Agent Skills-compatible runtime.

### One-Line CLI Install

The preferred method uses the `npx skills` command:

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

```

To specify a particular runtime, add the `-a` flag:

```bash
npx skills add alchaincyf/zhangxuefeng-skill -a claude-code

```

### Manual Clone

For inspection or custom installation paths, clone directly to the runtime's skills directory:

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

```

Once installed, trigger the skill by sending a prompt that references Zhang Xuefeng's perspective, such as:

```text
> 用张雪峰的视角帮我分析一下计算机专业的就业前景

```

The skill will respond according to the rules defined in **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)**, implementing the role-play constraints and data-first workflow specified in the machine-readable definition.

## Programmatic Access

You can embed the documentation content into your own projects by fetching the raw files directly.

Fetch the skill definition for runtime inspection:

```python
import requests

url = "https://raw.githubusercontent.com/alchaincyf/zhangxuefeng-skill/main/SKILL.md"
skill_yaml = requests.get(url).text
print(skill_yaml[:200])  # preview

```

Load the example conversation to create unit tests:

```python
from pathlib import Path

example_path = Path("examples/demo-conversation.md")
conversation = example_path.read_text()
assert "张雪峰" in conversation

```

## Summary

- **Primary documentation** is located in [`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md) (overview), [`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md) (specification), and [`examples/demo-conversation.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/examples/demo-conversation.md) (usage examples).
- **Source research materials** reside in `references/research/` as six numbered files ([`01-writings.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/01-writings.md) through [`06-timeline.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/06-timeline.md)).
- **Installation** is supported via `npx skills add`, manual git clone, or reference-only usage.
- **SKILL.md** serves as the machine-readable contract that defines the role-play rules, workflow, and expressive DNA consumed by Agent Skills runtimes.

## Frequently Asked Questions

### Where is the zhangxuefeng-skill definition file located?

The skill definition is located at **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)** in the repository root. This file contains the YAML front-matter, role-play rules, answer flow, and expressive DNA that the Agent Skills runtime consumes to instantiate the Zhang Xuefeng persona.

### How do I install zhangxuefeng-skill manually?

Clone the repository directly into your runtime's skills directory using `git clone https://github.com/alchaincyf/zhangxuefeng-skill ~/.claude/skills/zhangxuefeng-skill`. This method is documented in **[`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md)** and is useful for custom path configurations or offline inspection.

### What is the difference between README.md and SKILL.md?

**[`README.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/README.md)** provides human-readable documentation including installation instructions, project overview, and mental model summaries, while **[`SKILL.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/SKILL.md)** contains the machine-readable specification with YAML front-matter, deterministic response rules, and the actual runtime configuration that governs the skill's behavior.

### Where can I find source material about Zhang Xuefeng's writings and interviews?

Primary source materials are located in **[`references/research/01-writings.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/references/research/01-writings.md)** (books and articles) and **[`references/research/02-conversations.md`](https://github.com/alchaincyf/zhangxuefeng-skill/blob/main/references/research/02-conversations.md)** (interviews and talks). These files, along with four additional research documents in the same directory, provide the raw material distilled into the skill's knowledge base.