ThinkBuddy Coding Skills

Reusable Codex skills for software product planning, implementation, auditing, and release. The repository starts with a production-quality desktop GUI application development skill and can host additional related coding skills over time.

Included skills

Skill	Display name	Version	Invoke
desktop-guiapp-development	桌面应用开发	1.1.1	$desktop-guiapp-development

The display name and implicit Chinese trigger are “桌面应用开发”. Codex skill identifiers must use lowercase ASCII letters, digits, and hyphens, so explicit $... invocation uses $desktop-guiapp-development.

Install

git clone https://github.com/byteswalk/thinkbuddy-coding-skills.git
cd thinkbuddy-coding-skills
.\scripts\install.ps1

Install one skill:

.\scripts\install.ps1 -Skill desktop-guiapp-development

Update

.\scripts\update.ps1

The update script performs a fast-forward-only pull and reinstalls the selected skills into $CODEX_HOME\skills or ~\.codex\skills.

Validate

.\scripts\validate.ps1

Validation uses the official Codex skill-creator validator installed on the machine. GitHub Actions also validates catalog consistency, metadata, references, and repository layout on every push and pull request.

Versioning

• Each skill has an independent semantic version in catalog.json.
• Tag skill releases as <skill-id>-v<version>, for example desktop-guiapp-development-v1.0.0.
• Update the skill version and root CHANGELOG.md in the same commit.
• Breaking behavior or workflow changes increment the major version.
• New backward-compatible guidance increments the minor version.
• Corrections and wording fixes increment the patch version.

Repository layout

skills/
  desktop-guiapp-development/
    SKILL.md
    agents/
    references/
scripts/
  install.ps1
  update.ps1
  validate.ps1
catalog.json

Keep user documentation and release history at the repository root. Skill folders should contain only files required by the skill at runtime.