Repolode
Submit
voidforall

voidforall/fengshui.skill

An Agent Skills-compliant prompt package that turns traditional Chinese feng shui (Xuankong flying stars, Bazhai, date selection) into a conversational advisor for AI coding agents.

View on GitHub
Stars
339
Forks
50
Open issues
0
Last commit
last month

What is it?

This project packages traditional Chinese feng shui (kanyu) knowledge as an Agent Skills module: a SKILL.md file with a persona and methodology, plus reference notes and worked examples. Once installed in an compatible agent such as Claude Code or Codex CLI, the agent can analyze a home layout using Xuankong flying-star charts, apply Bazhai (Eight Mansions) methods based on the occupant's birth-year trigram, and suggest auspicious dates for moving in or opening a business using the Almanac-based day-selection system.

The skill also covers identifying common external threats such as road alignment and sharp corners, along with traditional remedies, and answers theoretical questions about feng shui terminology and classical texts. It is framed as cultural and advisory guidance rather than fortune-telling, and it is installed through the npx skills tool or by cloning the repository into an agent's skills directory.

Key features

  • 01Builds Xuankong flying-star charts from house orientation and move-in year.
  • 02Applies Bazhai methods using the occupant's birth-year trigram.
  • 03Suggests auspicious dates for moving, opening a business, or groundbreaking.
  • 04Identifies common external sha-qi such as road alignment and offers remedies.
  • 05Installs across agents that support the Agent Skills standard.

Use cases

  • Getting a basic room-layout reading for a new apartment or house.
  • Choosing a moving-in or business-opening date with traditional almanac rules.
  • Learning the meaning of feng shui terms and classical text passages.

Quick start

  1. 1

    Install the skill with the cross-tool installer

    npx skills add voidforall/fengshui.skill
  2. 2

    Or install for Codex CLI specifically

    npx skills add voidforall/fengshui.skill --agent codex
  3. 3

    Then describe your housing or date-selection question in natural language in a supported agent

Things to know

  • The content is based on traditional feng shui theory and is intended for learning and cultural discussion, not as a basis for major decisions.
  • The skill is a prompt package with reference files, so it needs a compatible Agent Skills agent to run.

Topics

#feng-shui#agent-skills#claude-code#prompt#chinese-culture#date-selection

FAQ

What is fengshui.skill?
An Agent Skills-compliant prompt package that turns traditional Chinese feng shui (Xuankong flying stars, Bazhai, date selection) into a conversational advisor for AI coding agents. This project packages traditional Chinese feng shui (kanyu) knowledge as an Agent Skills module: a SKILL.md file with a persona and methodology, plus reference notes and worked examples. Once installed in an compatible agent such as Claude Code or Codex CLI, the agent can analyze a home layout using Xuankong flying-star charts, apply Bazhai (Eight Mansions) methods based on the occupant's birth-year trigram, and suggest auspicious dates for moving in or opening a business using the Almanac-based day-selection system.
Is fengshui.skill free to use? What license does it have?
fengshui.skill has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is fengshui.skill still maintained?
Updated within 6 months. The last commit to fengshui.skill was on Sep 20, 2026.
What can I use fengshui.skill for?
Getting a basic room-layout reading for a new apartment or house. Choosing a moving-in or business-opening date with traditional almanac rules. Learning the meaning of feng shui terms and classical text passages.
How do I install fengshui.skill?
Install the skill with the cross-tool installer: npx skills add voidforall/fengshui.skill Or install for Codex CLI specifically: npx skills add voidforall/fengshui.skill --agent codex Then describe your housing or date-selection question in natural language in a supported agent
Where can I get fengshui.skill?
The source code and installation instructions are on GitHub: https://github.com/voidforall/fengshui.skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects