luck-skill

Luck Skill is a small add on for AI coding assistants that brings a Chinese almanac, known as the huangli, into chat. The Chinese almanac is a centuries old daily guide that tells people which activities are favoured on a given day, which directions are lucky, which colours to wear, and which two hour blocks of the day are auspicious. This project takes that traditional content and gives modern, light hearted advice through your AI assistant of choice.

The README lists the kinds of questions it answers. There is a daily luck card that summarises the day at a glance, including the overall quality, lucky directions, clothing colours, and a list of things to do or avoid. There is a scenario check, where you can ask whether today is a good day for a specific action such as deploying code, signing a contract, going to a job interview, travelling, or even gaming. There are also clothing colour suggestions based on the Five Elements theory, an hourly luck readout, and what the README calls Peng Zu taboos, ancient cautions retold as everyday tips. Responses are bilingual, switching between English and Chinese depending on the language you use.

The author calls this a skill, which in this context means a small bundle of files that an AI coding assistant loads and treats as new abilities. The README gives one line install commands for three assistants: Claude Code, OpenAI Codex, and OpenCode. Each one clones the repository into a different folder under your home directory where that assistant looks for skills. After installation you can invoke it with a slash command like slash luck-skill, or simply ask a natural question and the assistant will route to it.

The almanac data itself is not bundled with this project. It is fetched from a separate repository by the same author called Toolbox, which generates and hosts the daily entries. The README is careful to mark the skill as cultural and entertainment content only, and to tell users not to use it for medical, legal, financial, employment, or major contract decisions. The licence is MIT.