# Wiki Publish

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-prairieaster-ai-claude-code-skills-wiki-publish`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [PrairieAster-Ai](https://agentstack.voostack.com/s/prairieaster-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [PrairieAster-Ai](https://github.com/PrairieAster-Ai)
- **Source:** https://github.com/PrairieAster-Ai/claude-code-skills/tree/main/skills/wiki-publish

## Install

```sh
agentstack add skill-prairieaster-ai-claude-code-skills-wiki-publish
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Wiki Publish Skill

The **publishing substrate** shared by the documentation producers. It owns *how*
content reaches the GitHub Wiki and stays current — not *what* the content is.
Producers generate pages + a facts JSON; this skill stamps and publishes them.

## Separation of concerns

| Concern | Owner |
|---|---|
| **What** to document — TSDoc → Reference pages, team pages, Page-Anatomy | **code-readability** |
| **What** to measure — the CodeHealth roll-up + dashboard facts | **code-health** |
| **How** it's stamped + pushed to the wiki (markers, SSH clone/commit/push, guard) | **wiki-publish** (this) |

The `quality-steward` agent composes all three in its "document" step: producers
write pages + facts, then `wiki-publish` stamps and pushes them.

## The marker convention

Hand-authored prose stays curated; only the *facts* are regenerated, inside
`…` regions. Each producer owns a prefix:

- `ch:` — CodeHealth (badge, chart, pie, MI counts, hotspots…) — from `/code-health`
- `cr:` — code-readability team pages (prereqs, scripts, env, stack)

A new producer just picks a prefix and emits a facts JSON; `stamp.mjs` is generic.

## Scripts

- **`stamp.mjs   ...`** — fill every ``
  region from the facts JSON. Block values (charts/tables/mermaid) are padded onto
  their own lines. Idempotent. (Generalizes the old `stamp-codehealth.mjs` and the
  team-page stamping.)
- **`wiki-repo.mjs`** — git plumbing:
  - `url ` → derive the `git@…/.wiki.git` SSH URL
  - `clone  ` → clone the wiki
  - `guard  ...` → **fail if a page to be written lacks the marker**
    (i.e. it's hand-authored — never clobber it)
  - `push  ""` → add/commit/push (no-op if clean; clear SSH-auth error)

## Publish protocol (what the steward / producers follow)

1. `wiki-repo.mjs url` → `clone` the wiki to a scratch dir.
2. Producers write/refresh their pages into it and emit a facts JSON.
3. `wiki-repo.mjs guard "" ` before overwriting any
   generated page — protects hand-authored pages.
4. `stamp.mjs   ` to fill the marker regions.
5. (code-readability's `linkify-wiki.mjs` if wiring source links.)
6. `wiki-repo.mjs push  ""`.

## Don'ts

- Don't put *content generation* here — that's code-readability / code-health.
- Don't overwrite a page that lacks the generated marker (use `guard`).
- Don't assume HTTPS/PAT can push a wiki — it's **SSH only**.

## Files

- `scripts/stamp.mjs` — generic marker stamper
- `scripts/wiki-repo.mjs` — url / clone / guard / push

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [PrairieAster-Ai](https://github.com/PrairieAster-Ai)
- **Source:** [PrairieAster-Ai/claude-code-skills](https://github.com/PrairieAster-Ai/claude-code-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-prairieaster-ai-claude-code-skills-wiki-publish
- Seller: https://agentstack.voostack.com/s/prairieaster-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.