feat: migrate skills review desk to astro

2026-09-05 16:54:37 +00:00
parent 107e429fb9
commit 71e4775573
66 changed files with 8184 additions and 96 deletions
@@ -0,0 +1,52 @@
+---
+name: marcos-silva-skills
+description: Index for Marcos Silva's submitted Confluence + documentation skill set.
+type: index
+---
+
+# Marcos Silva — Submitted Skills
+
+Tooling for creating, reviewing, and publishing Confluence pages in the Netcracker
+BASS / AVP spaces, focused on `mcp-atlassian`, PlantUML diagrams, and pre-post
+review.
+
+## Skills
+
+| Skill | Job | When to invoke |
+|-------|-----|----------------|
+| [confluence-page](skills/confluence-page/SKILL.md) | Create or update a Confluence page from a local storage-format draft via mcp-atlassian | Drafting a page, scaffolding from a template, mirroring content into a space |
+| [page-reviewer](skills/page-reviewer/SKILL.md) | Audit a Confluence-ready body before it is posted | Just before `confluence_create_page_from_file` or `confluence_update_page_from_file` |
+| [unslop](skills/unslop/SKILL.md) | Strip AI slop from prose before posting | After drafting, before review |
+| [diagram-plantuml](skills/diagram-plantuml/SKILL.md) | Embed PlantUML correctly inside a Confluence page | Page needs a sequence, component, class, state, or activity diagram |
+
+## Scripts
+
+| Script | Purpose |
+|--------|---------|
+| [scripts/check-mcp-atlassian.sh](scripts/check-mcp-atlassian.sh) | Detect whether `mcp-atlassian` is wired up; print install hint if not |
+| [scripts/new-page.sh](scripts/new-page.sh) | Scaffold a new page from a template into a draft folder |
+| [scripts/dry-run-publish.sh](scripts/dry-run-publish.sh) | Pre-flight the page body (lint, slop-check, lint diagrams) without posting |
+
+## Templates
+
+See [templates/](templates/) for ready-to-fill body templates:
+
+- `hub-page.md` — overview / landing pages
+- `how-to.md` — step-by-step runbook
+- `rfc.md` — request for comment
+- `postmortem.md` — incident write-up
+
+## Conventions
+
+Mirrors in `~/Netcracker/Projects/NDO/knowledge/confluence/<SPACE>/` are
+read-only local copies. Edit upstream, then re-pull — never patch the mirror
+body in place. Skill bodies in this folder are the working copy for agents;
+when a skill and the upstream page disagree, the upstream page wins and the
+skill gets updated.
+
+## References
+
+- BASS Confluence — https://bass.netcracker.com
+- mcp-atlassian upstream — https://github.com/sooperset/mcp-atlassian
+- NDO knowledge base — `~/Netcracker/Projects/NDO/knowledge/`
+- Cursor MCP approval status (governance) — see `BASS/cursor-mcps-approval-status.md`