Skip to content

Repository files navigation

LibreCopy Grok Build

LibreCopy Grok Build

Technical writing and docs-as-code for Grok Build: Grok-native skills plus every LibreCopy pack plugin, from one marketplace

Stars License Last Commit Docs Grok Build


Technical writing / docs-as-code skills for Grok Build — ported and melted from LibreCopy-Claude-Code, not a dumb copy.

Status: v1.0.0. Three skills are melted into the Grok-native plugin libre-copy-grok (docs-critique, api-docs, style-guide). The other six are honest stubs in stubs/, each pointing at the pack plugin that holds the real depth. See docs/DEPTH_MATRIX.md and the kintsugi ledger.

Why this exists

AI docs have tells. LibreCopy owns README engineering, API narrative, runbooks, changelogs, anti-slop. Grok Build needs the same job with Grok-native skills, .grok/, and truth-seeking voice. This repo counts only what it has melted.

Install

One marketplace brings both layers: the Grok-native plugin melted here, and every plugin of the LibreCopy-Claude-Code pack, pinned to one commit of the pack. Grok reads the pack plugins as they are.

grok plugin marketplace add HermeticOrmus/LibreCopy-Grok-Build
grok plugin install libre-copy-grok@libre-copy-grok --trust

Grok installs a plugin only with --trust, because a plugin can run hooks, MCP servers and skills on your machine. Read what you trust: each entry's source is linked in .grok-plugin/marketplace.json.

Then add the pack plugins your docs need, for example:

grok plugin install readme-engineering@libre-copy-grok --trust
grok plugin install api-documentation@libre-copy-grok --trust

QUICK_START.md has the loop that installs every entry, the dogfood clone, and the manual copy path. From a clone:

git clone https://github.com/HermeticOrmus/LibreCopy-Grok-Build.git
cd LibreCopy-Grok-Build
# Dogfood: .grok/skills/ holds a copy of the skill bodies and stubs.
# Other project: cp -R plugins/libre-copy-grok/skills/* /path/to/your-project/.grok/skills/

Doctrine: install grok-build-reality-os AGENTS.md on the machine first.

Depth / quality

This pack targets L3–L4 hygiene on the Reality OS quality ladder (SECURITY linked, contributing describes this repo, inventory honest, suite map complete). Melted skills are inventory in docs/DEPTH_MATRIX.md. This pass does not claim L5.

Artifact This repo now Where
Grok-native skills 3 melted plugins/libre-copy-grok/skills/
Stub skills 6, not installed stubs/, each names its pack plugin
Agents 1 stub (copy-orchestrator), not installed AGENTS/
Plugins in the marketplace 1 Grok-native + 21 pack entries .grok-plugin/marketplace.json, pinned to one pack commit

Pack entries are LibreCopy-Claude-Code plugins installed through this marketplace. They are not melted here, and they are not counted as this repo's skills. Do not paste Claude plugin/agent/command totals here. Update docs/DEPTH_MATRIX.md when something melts, and run scripts/pin-pack.sh when the pack changes.

Skills

Skill Status Job Pack plugin
docs-critique melted Daily critique loop for one page melted from documentation-testing + content-strategy
api-docs melted API narrative: auth, first success, the error they will hit melted from api-documentation
style-guide melted Ten-rule voice. Em dashes optional (Diego voice) melted from style-guides
readme-engineering stub README structure (Diátaxis-aware) real depth in readme-engineering
runbook-writing stub Incident / ops runbooks real depth in runbook-writing
changelog-discipline stub CHANGELOG + semver honesty real depth in changelog-management
error-messages stub Actionable error UX real depth in error-messages
tutorial-creation stub Tutorial sequencing real depth in tutorial-creation
anti-slop stub AI-doc tells none one to one; nearest style-guides, documentation-testing

Agent: AGENTS/copy-orchestrator.md — stub coordinator for a full docs pass.

Layout (Grok Build)

plugins/libre-copy-grok/  # the Grok-native plugin: manifest + melted SKILL.md bodies
stubs/                    # stub skills + the v0 bundle stub; not installed
AGENTS/                   # suite agents
docs/                     # DEPTH_MATRIX, MELT_RULES
scripts/pin-pack.sh       # re-pins the pack entries to the pack's main
.grok-plugin/             # marketplace: the plugin + every pack plugin, pinned
.grok/skills/             # dogfood copy of the plugin skills and stubs (CI checks it)

Claude's .claude/ maps to Grok skills + AGENTS.md + .grok/. Melt rules: docs/MELT_RULES.md.

Kintsugi ledger

Every crack found in v0 and how this release seals it, with the file that shows the seal: LEDGER.md.

Feedback and contributing

Tell us what worked and what is missing with the feedback form. When Grok picks the wrong skill, file a routing miss. Ways to contribute are in CONTRIBUTING.md.

Gold Hat

GOLD_HAT.md — empower or extract? Canonical manifesto: gold-hat-manifesto.

Teach the writing move. Do not leave the reader dependent on the skill.

Security

SECURITY.md — this pack is docs and prompts. Still: never embed secrets in skills, templates, or examples.

Suite

License

MIT — see LICENSE.

About

Technical writing & docs-as-code skills for Grok Build — melted from LibreCopy. Gold Hat. Liquid Gold.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages