fengshui.skill (堪舆子)
A traditional feng shui skill: flying-star charts, Eight Mansions layouts and auspicious dates, with calendar math done in code.
- 417 ★ on the repository
- Last commit
Minimal access
Why this level
- The skill runs a local Python script for calculations and calls no paid services
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/fengshui-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill runs a local Python script for calculations and calls no paid services
This is third-party code. Review the repository files before installing.
What it does
fengshui.skill, a skill built on the open Agent Skills standard, turns an agent into a feng shui consultant. It lays out a flying-star chart from a house orientation and move-in year, picks favourable directions from the occupant's gua number, finds good days for moving, opening a business or breaking ground, and names common external hazards with ways to soften them. Calculation lives in `scripts/fengshui.py`: star placement, lookup tables and the Chinese calendar are computed by code, while the model gathers inputs and explains the result. Files in `references/` follow the classical treatises the README cites.
Who it is for. People who want a traditional feng shui consultation grounded in Chinese sources: homeowners, small-business owners and writers on Chinese culture.
Good fit when
- You need a flying-star chart for a flat with known orientation and move-in year.
- You are choosing a day to move, open a shop or start renovation.
- You want a term or classical passage explained.
- A content writer checks calendar calculations for a feng shui article.
Not a fit when
- You need a scientific or legal conclusion, feng shui here is a cultural practice.
- A housing purchase or a health decision would rest on the chart alone.
- The inputs are unknown: without orientation and date no chart can be built.
Example request
Build a flying-star chart for a house facing south, move-in 2026, and pick three moving days in November.Limitations
Materials and terminology are in Chinese. The calendar script needs the library from `requirements.txt` (the README names `lunar_python`). The author states this is not fortune-telling and sells no charms, yet the conclusions remain traditional interpretation with no scientific backing. Output depends on input accuracy: a wrong facade direction or year shifts the whole star chart. Before use, check the repository's current state and the version you rely on.
How to disable. Delete the skill folder from the agent's skills directory, for example `~/.claude/skills/fengshui-master`. Remove the Python dependencies separately.
FAQ
Who computes dates and stars, the model or the script?
The script `scripts/fengshui.py`. The model asks questions and explains the result, so calendar and table errors are ruled out by code rather than guessed.
Which methods are covered?
Xuan Kong flying stars, the Eight Mansions scheme, date selection in the Zeri tradition and a review of common external hazards such as a road pointing at the house.
Does it work outside Chinese?
The materials are written in Chinese. The agent can answer in the user's language, but terms and references stay Chinese.
Are there tests?
The repository has a `tests.yml` workflow and regression tests for the calculations, as the README says.
Is Python installation needed?
Yes, for the calculation script. Run `pip install -r requirements.txt` in the skill folder; the README names the `lunar_python` library.
Discussion
No questions or reviews yet.
Related
SkillsEight skills to compute a Vedic natal chart from birth date, time and place and analyze career, relationships and compatibility.
A collection of open Agent Skills by Huashu for content work: slides, design, data processing, video scripts and text proofreading
A set of 131 redfoxdata skills for Chinese social data and content: search, account analysis, video downloads, titles and banned-word checks
Twenty-two skills for marketing and engineering: copy, social posts, Chrome extensions, PromQL, research and skill checks
Codex skills for the Xiaohuang brand character: light hand-drawn slides, article covers and web slides in one style
Two dozen skills: video scripts and covers, publishing to X and Substack, security scanners, Claude Code session export
README in short
The skill consists of `SKILL.md`, reference files and a calculation script. The model asks questions and explains; code does the calculation and calendar.