alchaincyf/huashu-skills

What is huashu‑skills?

huashu‑skills is a curated collection of Agent Skills – small, self‑contained modules that extend AI assistants such as Claude Code, Codex, Kimi Code, and similar agents. Each skill follows a standard SKILL.md format that tells the agent how to run the module, what inputs it expects, and what output it produces.

The repository is essentially a catalog:

• 52 skills are organized into three layers:
  1. Flagship Skills – 16 full‑featured systems, each living in its own GitHub repo (e.g. huashu‑design, huashu‑excel).
  2. Persona Skills – 14 “thought‑process” skills that emulate the decision‑making style of famous people (Jobs, Musk, Munger, etc.). They are generated by the nuwa‑skill tool.
  3. Built‑in Skills – 22 lightweight utilities that ship directly inside this repo (slide generation, proofreading, markdown‑to‑PDF, update checker, etc.).
• A machine‑readable index (skills.json) lists every skill with its repository name, sub‑directory, category and keywords, so an AI agent can automatically discover and install the right tool.

Who might use it?

• Developers building AI‑augmented workflows – they can drop a skill into ~/.claude/skills/ (or a project‑local .claude/skills/) and the agent instantly gains new capabilities.
• Content creators – skills for slide decks, video scripts, social‑media post generation, proofreading, and design‑philosophy advice.
• Data analysts – huashu‑excel turns messy spreadsheets into clean reports with only the openpyxl library.
• Anyone who wants a plug‑and‑play way to extend their Claude/Codex/Kimi agents without writing code.

How does installation work?

1. Flagship or Persona skills (stand‑alone repos):

   git clone https://github.com/alchaincyf/<repo>.git ~/.claude/skills/<repo>
   

2. Built‑in skills (sub‑folders of this repo):

   git clone --depth 1 https://github.com/alchaincyf/huashu-skills.git /tmp/huashu-skills
   cp -r /tmp/huashu-skills/<skill‑folder> ~/.claude/skills/
   

3. Restart the agent session and the new skill is ready.

Keeping skills up‑to‑date

The repository ships an updater skill (huashu‑skill‑updater). It records metadata for each installed skill and can, on demand or via a cron job, compare the local commit hash with the latest commit on GitHub, reporting any out‑of‑date modules.

Example built‑in skills

Skill	What it does
huashu‑slides	Turn a single sentence into a full PowerPoint deck (structure, design style, AI‑generated illustrations).
huashu‑proofreading	Three‑pass AI‑driven copy edit that removes “AI‑tone”.
huashu‑md‑to‑pdf	Convert Markdown to a professionally‑styled Apple‑like PDF book.
huashu‑agent‑swarm	Run multiple agents in parallel without a master, coordinated via Git.
huashu‑skill‑updater	Scan installed skills, check remote repos, and suggest updates.

Why it matters

Agent Skills are a new way to modularize AI functionality—instead of hard‑coding every capability, you ship a tiny, declarative package that any compatible agent can load at runtime. huashu‑skills provides a ready‑made ecosystem of such packages, covering design, data work, writing, video production, and even meta‑tools for evolving the skills themselves.

---

TL;DR: huashu‑skills is a real, open‑source index of 52 plug‑in modules for Claude/Codex/Kimi‑style AI agents. Install a skill with a single git clone (or copy a sub‑folder), and the agent instantly gains the described capability. The repo also includes an auto‑updater to keep those modules current.