TechArticle

wiki Agent Skill

Infobox

headline: wiki Agent Skill
description: Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages.

The wiki skill is procedural knowledge for coding agents working with Wiki CLI. One hub routes to four workflow references — install, create, improve, and deploy — plus deterministic scripts for CLI verification and CI-style audits.

Canonical skill file: skills/wiki/SKILL.md. Skills live under skills/ and are not wiki content — do not add that folder to wiki.inputs.

Install

npx skills add wazootech/wiki@wiki -g -y

-g installs for all projects; omit -g for the current project only. -y skips prompts. See Wiki Skills for badge and refresh commands.

Routing

Intent	Reference	Stop when
CLI missing or stale	`skills/wiki/references/install.md`	CLI verified or blocker reported
New wiki / `wiki init`	`skills/wiki/references/create.md`	Scaffold summarized
Audit / pre-PR / lint failures	`skills/wiki/references/improve.md`	Findings report delivered
GitHub Pages / CI deploy	`skills/wiki/references/deploy.md`	Workflow + URLs summarized

Read one reference per turn unless the user explicitly asked for a multi-step flow (for example install → create → deploy).

Scripts

bash skills/wiki/scripts/verify-cli.sh
bash skills/wiki/scripts/audit.sh -c path/to/wiki.yaml [FILE...]

verify-cli.sh exits 0 when wiki and fmt capability pass, 1 when missing, 2 when stale. audit.sh runs fmt → lint → check → render (--strict / --check), then wiki link --check only when wired in .github/workflows/.

Install workflow

Detect whether wiki is on PATH, install wazootech-wiki when needed, verify with wiki --help and a fmt capability probe, and exit with a ready-to-go message. Does not suggest wiki init unless the user asks.

See skills/wiki/references/install.md.

Create workflow

Non-interactive wiki init (flags, not prompts) plus a short preferences wizard for logo glyph (--site-name), first page, and light wiki.yaml tweaks. Requires wiki on PATH before any init or file edits. Default post-init wiki check --strict with opt-out.

See skills/wiki/references/create.md and Wiki Subcommand init.

Improve workflow

Survey a wiki as a read-only advisor: run validators, cite evidence, deliver a prioritized findings report. Never edits wiki files unless explicitly asked. Suggest repairs (wiki fmt, wiki link --fix-broken) only when asked.

See skills/wiki/references/improve.md, Wiki Configuration, and Design Philosophies.

Deploy workflow

Align site.base_url, add .github/workflows/deploy.yml from wholesale templates, set the correct upload-pages-artifact path, and remind you to enable Pages → GitHub Actions. Requires wiki on PATH and an existing wiki.yaml.

Workflow assets (embed one template in full; substitute CONFIG_PATH, SITE_BASE_URL, ARTIFACT_PATH only):

skills/wiki/references/workflow-template-uv.yml — uv monorepo
skills/wiki/references/workflow-template-pip.yml — pip standalone
skills/wiki/references/alignment-checklist.md

See skills/wiki/references/deploy.md and Deploying to GitHub Pages.

Getting Started — install and daily commands for humans
Wiki Skills — install and refresh
Procedural Knowledge

ContentsOn this page

[hide]

(Top)
Install
Routing
Scripts
Install workflow
Create workflow
Improve workflow
Deploy workflow
Related

Backlinks

Categories:

TechArticle

Talk / Local Notes: wiki Agent Skill

Your personal scratchpad for this page (saved locally in browser)

0 characters

View Source: wiki Agent Skill

Raw Markdown source code of the document

# wiki Agent Skill

The **`wiki`** skill is procedural knowledge for coding agents working with [Wiki CLI](https://github.com/wazootech/wiki). One hub routes to four workflow references — install, create, improve, and deploy — plus deterministic scripts for CLI verification and CI-style audits.

Canonical skill file: [`skills/wiki/SKILL.md`](https://github.com/wazootech/wiki/blob/main/skills/wiki/SKILL.md). Skills live under `skills/` and are **not** wiki content — do not add that folder to `wiki.inputs`.

## Install

```bash
npx skills add wazootech/wiki@wiki -g -y
```

`-g` installs for all projects; omit `-g` for the current project only. `-y` skips prompts. See [Wiki Skills](Wiki_Skills.md) for badge and refresh commands.

## Routing

| Intent                         | Reference                           | Stop when                        |
| ------------------------------ | ----------------------------------- | -------------------------------- |
| CLI missing or stale           | `skills/wiki/references/install.md` | CLI verified or blocker reported |
| New wiki / `wiki init`         | `skills/wiki/references/create.md`  | Scaffold summarized              |
| Audit / pre-PR / lint failures | `skills/wiki/references/improve.md` | Findings report delivered        |
| GitHub Pages / CI deploy       | `skills/wiki/references/deploy.md`  | Workflow + URLs summarized       |

Read one reference per turn unless the user explicitly asked for a multi-step flow (for example install → create → deploy).

## Scripts

```bash
bash skills/wiki/scripts/verify-cli.sh
bash skills/wiki/scripts/audit.sh -c path/to/wiki.yaml [FILE...]
```

`verify-cli.sh` exits `0` when `wiki` and `fmt` capability pass, `1` when missing, `2` when stale. `audit.sh` runs fmt → lint → check → render (`--strict` / `--check`), then `wiki link --check` only when wired in `.github/workflows/`.

## Install workflow

Detect whether `wiki` is on PATH, install **`wazootech-wiki`** when needed, verify with `wiki --help` and a **`fmt` capability probe**, and exit with a ready-to-go message. Does not suggest `wiki init` unless the user asks.

See `skills/wiki/references/install.md`.

## Create workflow

Non-interactive `wiki init` (flags, not prompts) plus a short preferences wizard for logo glyph (`--site-name`), first page, and light `wiki.yaml` tweaks. Requires **`wiki` on PATH** before any init or file edits. Default post-init `wiki check --strict` with opt-out.

See `skills/wiki/references/create.md` and [Wiki Subcommand init](Wiki_Subcommand_init.md).

## Improve workflow

Survey a wiki as a read-only advisor: run validators, cite evidence, deliver a prioritized findings report. Never edits wiki files unless explicitly asked. Suggest repairs (`wiki fmt`, `wiki link --fix-broken`) only when asked.

See `skills/wiki/references/improve.md`, [Wiki Configuration](Wiki_Configuration.md), and [Design Philosophies](Design_Philosophies.md).

## Deploy workflow

Align `site.base_url`, add `.github/workflows/deploy.yml` from wholesale templates, set the correct `upload-pages-artifact` path, and remind you to enable **Pages → GitHub Actions**. Requires **`wiki` on PATH** and an existing **`wiki.yaml`**.

Workflow assets (embed one template in full; substitute `CONFIG_PATH`, `SITE_BASE_URL`, `ARTIFACT_PATH` only):

- `skills/wiki/references/workflow-template-uv.yml` — uv monorepo
- `skills/wiki/references/workflow-template-pip.yml` — pip standalone
- `skills/wiki/references/alignment-checklist.md`

See `skills/wiki/references/deploy.md` and [Deploying to GitHub Pages](Deploying_to_GitHub_Pages.md).

## Related

- [Getting Started](Getting_Started.md) — install and daily commands for humans
- [Wiki Skills](Wiki_Skills.md) — install and refresh
- [Procedural Knowledge](Procedural_Knowledge.md)

Metadata: wiki Agent Skill

RDF representation compiled from frontmatter

{
  "@context": {
    "schema": "https://schema.org/",
    "wiki": "https://wazootech.github.io/wiki/"
  },
  "@id": "wiki:Wiki_Skill",
  "@type": "schema:TechArticle",
  "schema:description": "Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages.",
  "schema:headline": "wiki Agent Skill"
}

@prefix schema: <https://schema.org/> .
@prefix wiki: <https://wazootech.github.io/wiki/> .

wiki:Wiki_Skill a schema:TechArticle ;
    schema:description "Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages." ;
    schema:headline "wiki Agent Skill" .

@prefix schema: <https://schema.org/> .
@prefix wiki: <https://wazootech.github.io/wiki/> .

wiki:Wiki_Skill a schema:TechArticle ;
    schema:description "Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages." ;
    schema:headline "wiki Agent Skill" .

<?xml version="1.0" encoding="utf-8"?>
<rdf:RDF
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns:schema="https://schema.org/"
>
  <rdf:Description rdf:about="https://wazootech.github.io/wiki/Wiki_Skill">
    <rdf:type rdf:resource="https://schema.org/TechArticle"/>
    <schema:headline>wiki Agent Skill</schema:headline>
    <schema:description>Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages.</schema:description>
  </rdf:Description>
</rdf:RDF>

<https://wazootech.github.io/wiki/Wiki_Skill> <https://schema.org/headline> "wiki Agent Skill" .
<https://wazootech.github.io/wiki/Wiki_Skill> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schema.org/TechArticle> .
<https://wazootech.github.io/wiki/Wiki_Skill> <https://schema.org/description> "Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages." .

@prefix schema: <https://schema.org/> .
@prefix wiki: <https://wazootech.github.io/wiki/> .

_:Na3392ce8410a466cb776ee8b970edc9b {
    wiki:Wiki_Skill a schema:TechArticle ;
        schema:description "Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages." ;
        schema:headline "wiki Agent Skill" .
}

<https://wazootech.github.io/wiki/Wiki_Skill> <https://schema.org/headline> "wiki Agent Skill" .
<https://wazootech.github.io/wiki/Wiki_Skill> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schema.org/TechArticle> .
<https://wazootech.github.io/wiki/Wiki_Skill> <https://schema.org/description> "Install Wiki CLI, scaffold workspaces, audit hygiene, and deploy to GitHub Pages." .