---
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`