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

The complete zhangxuefeng-skill documentation is located in the repository's README.md, SKILL.md, 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 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 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 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 – Books and written works
• 02-conversations.md – Interviews and talks
• 03-expression-dna.md – Stylistic and expressive DNA
• 04-external-views.md – External critiques and analyses
• 05-decisions.md – Major life and career decisions
• 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:

npx skills add alchaincyf/zhangxuefeng-skill

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

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:

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:

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

The skill will respond according to the rules defined in 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:

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:

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 (overview), SKILL.md (specification), and examples/demo-conversation.md (usage examples).
• Source research materials reside in references/research/ as six numbered files (01-writings.md through 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 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 and is useful for custom path configurations or offline inspection.

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

README.md provides human-readable documentation including installation instructions, project overview, and mental model summaries, while 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 (books and articles) and 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}