voidforall/fengshui.skill

What it solves

It transforms traditional Feng Shui (Kan Yu) knowledge into a structured, conversational AI skill. It allows users to get professional environmental analysis, auspicious date selection, and remedies for "sha qi" (negative energy) without needing to be an expert in complex traditional texts.

How it works

The project is built as a "Skill" following the Agent Skills open standard. It consists of a SKILL.md file (containing the persona and knowledge framework) and a set of reference documents. Because it is tool-agnostic, it can be installed into any AI agent that supports the standard, such as Claude Code or Codex CLI, enabling the agent to act as a specialized consultant using methods like Xuan Kong Flying Stars and Eight Mansions.

Who it’s for

• Homeowners looking to optimize their living environment based on traditional principles.
• People seeking auspicious dates for moving, opening a business, or construction.
• Students of traditional Kan Yu who want a digital reference for terminology and classic texts.

Highlights

• Multi-school approach: Integrates Xuan Kong Flying Stars, Eight Mansions, and Form School (Luan Tou) methodologies.
• Practical applications: Capable of calculating flying star charts, determining auspicious directions based on birth dates, and identifying external environmental hazards.
• Standardized format: Compatible with 30+ AI agents via the npx skills installer.
• Evidence-based: Grounded in classic texts like Shen's Xuan Kong and Xie Ji Bian Fang Shu.