sam-4screen-desktop 2026-9-16:5:48:7

300 areas/350 AI Pi Coding Agent/Pi Agent Extensions & Skills.md

@@ -186,6 +186,7 @@ v0.7.0, installed globally. 7 task tools: `TaskCreate`, `TaskList`, `TaskGet`, `
 | **ste-writing** | Rewrite prose (docs, READMEs, PRs, errors) into ASD-STE100 Simplified Technical English. Removes AI slop. Two modes: strict (procedures) and STE-flavored (general prose). Includes heuristic anti-slop linter (ste-lint.py). |
 | **project-diagramming-mermaid** | Outline codebase/project as Mermaid → `<project>/docs/<topic>.mmd` + render to `<project>/docs/diagrams/` via mmdc (nixpkgs mermaid-cli) → prompt for Archify follow-up. Per project: `/config-add skill project-diagramming-mermaid`. See [[Dev-Ops Tooling — Mermaid, Archify, Vikunja & Outline]] |
 | **project-diagramming-archify** | Mermaid or plain language → Archify JSON IR → validate (showcase) → deliver interactive HTML to `<project>/docs/<topic>-map.html`. Vendor renderer: `~/.agents/skills/archify` (v2.14). Per project: `/config-add skill project-diagramming-archify`. See [[Dev-Ops Tooling — Mermaid, Archify, Vikunja & Outline]] |
+| **project-docs** | Meta-skill to initiate or update multi-platform project documentation across Gitea (tech README), Obsidian (human/portfolio showcase), Mermaid/Archify (diagrams & map links), Vikunja (human tasks), and Outline (AI context index using `ste-writing`). Per project: `/config-add skill project-docs` |
 | **project-ops** | Task/stage/progress via **Vikunja** API + documentation via **Outline** API (bearer tokens in `10-secrets.conf`). Create/update tasks, move buckets, percent-done, read/write docs. Per project: `/config-add skill project-ops`. See [[Dev-Ops Tooling — Mermaid, Archify, Vikunja & Outline]] |
 | **design-build** | Generate production-ready HTML/Tailwind code from design specifications and DESIGN.md design tokens. |
 | **design-explore** | Generate UI design mockups as images for exploration and ideation. Supports DESIGN.md for design-token-accurate mockups. |
@@ -245,6 +246,36 @@ The `markitdown-vision` wrapper auto-sources `OPENROUTER_API_KEY` from `~/.confi
 
 ---
 
+## project-docs
+
+Meta-skill for initiating and updating multi-platform project documentation across human and AI systems. Orchestrates other skills (`nixos-workflow`, `project-diagramming-mermaid`, `project-diagramming-archify`, `obsidian-cli`, `ste-writing`).
+
+### Multi-Platform Roles
+
+| Platform | Target | Purpose & Tone | Key Output |
+| :--- | :--- | :--- | :--- |
+| **Gitea** | Developers / Resume | Technical repo README. Standard concise markdown. Highlights tech stack, usage, and portfolio skills. | `README.md` (embedded Mermaid diagram, Archify map links) |
+| **Obsidian** | Humans / Hiring Managers | **Human understanding**. Simple, layperson-friendly language. Highlights skills, tools, and employment concepts. | Vault note (`<ProjectName>.md`) |
+| **Mermaid + Archify** | Visualization | High-level system architecture and flow diagrams. | `docs/<topic>.mmd`, SVG/PNG renderings, hyperlinked nodes to `maps.lab.audasmedia.com.au` |
+| **Vikunja** | Humans | High-level task tracking for human team members. | Vikunja Project & Task Board |
+| **Outline** | AI Agents | **Deep AI context & document index**. Itemizes what is in each document in the collection so AI agents can inject specific files directly without searching. **Must use `ste-writing` skill** for terse, plain, slop-free text. | Outline Overview & Collection docs |
+
+### Workflow & Usage
+
+```bash
+# Enable per-project
+/config-add skill project-docs
+/reload
+
+# Invoke initiate mode
+"Initiate project documentation using project-docs"
+
+# Invoke update mode
+"Update project docs across Gitea, Obsidian, Vikunja, and Outline"
+```
+
+---
+
 ## falcode-zellij
 
 Zellij plugin + agent extensions that track all active AI coding panes (pi, OpenCode, Claude Code) across Zellij sessions in a floating popup. Jump to any pane with one keystroke. Shows attention icons on Zellij tabs when an agent starts/stops working.