mushroomTW

MushroomTW Skills

Documentation community

SOURCE https://github.com/mushroomTW/MushroomTW-Skills

Description

Five portable Agent Skills for README authoring, dependency decisions, repository bug audits, and SonarQube quality workflows. Open Agent Skills format — installable in Claude Code, Codex, Cursor, OpenCode, and other skills-compatible agents.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

MushroomTW-Skills

**English** | [繁體中文](README.zh.md)

Five portable Agent Skills for README authoring, dependency decisions, repository auditing, and SonarQube quality workflows. They follow the open Agent Skills format and can be installed into Claude Code, Codex, Cursor, OpenCode, and other skills-compatible agents; workflows that need SonarQube still require that capability on the host.

Each skill is a self-contained skill folder at the root; its documentation lives in `docs/`.

Skills

Skill	What it does	Docs	Directory
`excellent-readme`	Writes, improves, audits, or re-syncs a `README.md` against what the repository actually contains. Claims it cannot trace to a file are reported as gaps rather than written as facts.	EN ・繁中	`excellent-readme/`
`library-first`	Before you hand-roll retry, validation, caching, auth, or date handling, forces one search of that language's own ecosystem and a stated reason for the build-or-adopt decision.	EN ・繁中	`library-first/`
`local-sonarqube-setup`	Points a project at a local Docker SonarQube (`127.0.0.1:9000`), generates coverage with the project's own tooling, scans, and checks the Quality Gate. Reads the token from `SONAR_TOKEN` and keeps it out of files, arguments, logs, and replies.	EN ・繁中	`local-sonarqube-setup/`
`repository-bug-audit`	Reads the implementation, its callers, its config, and its tests before calling anything a bug. Delivers one machine-validated Markdown report, plus a 0–100 risk score in Comprehensive mode.	EN ・繁中	`repository-bug-audit/`
`sonarqube-fix-all`	Works through SonarQube findings in batches, verifying each batch against the build before moving on. Skips and reports b