Marcos Silva
53 lines
2.4 KiB
Markdown
53 lines
2.4 KiB
Markdown
---
|
|
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`
|