write-legible-c

Grok Build plugin that enforces a strict C11 machine-legibility standard when creating, refactoring, debugging, fixing, reviewing, or presenting C code.

It ships one skill, /write-legible-c, plus the full normative standard in references/c-standard.md (file layout, naming, orchestrator/leaf/adapter split, status enums + MODULE_TRY, bounded loops, assertion density, section-16 near-miss refactors, and repository-level AGENTS.md rules).

Install (recommended)

Add this marketplace, then install the plugin:

grok plugin marketplace add 7etsuo/write-legible-c
grok plugin install write-legible-c --trust

Enable it if it shows as installed but inactive:

grok plugin enable write-legible-c

Or in the TUI: /plugins → Plugins tab → select write-legible-c → Space to enable → r to reload (or start a new session).

One-shot install from the plugin path

grok plugin install 7etsuo/write-legible-c#plugins/write-legible-c --trust

Local clone

git clone https://github.com/7etsuo/write-legible-c.git
grok plugin marketplace add ./write-legible-c
grok plugin install write-legible-c --trust

Use

• Slash command: /write-legible-c
• Skills menu: /skills write-legible-c
• Auto: Grok loads the skill when you create, change, or review C (.c / .h)

What you get

plugins/write-legible-c/
  plugin.json
  skills/write-legible-c/
    SKILL.md
    references/c-standard.md   # full 18-section standard

Highlights from the standard:

• Fixed file layout and greppable module prefixes
• Status enums, boundary validation, MODULE_TRY only on non-acquiring paths
• Orchestrator / leaf / adapter function altitudes
• No naked literals (except obvious 0/1), named constants, designated inits
• Bounded loops, no recursion, early returns, assert density on mutators
• Section 16 near-miss diagnosis before accepting “already clean” C

Uninstall

grok plugin uninstall write-legible-c --confirm
# optional: drop the marketplace source
grok plugin marketplace remove 7etsuo/write-legible-c

Validate (maintainers)

grok plugin validate ./plugins/write-legible-c

License

MIT. The C standard text is part of this repository under the same license.