Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Pisanie

confluence

/confluence

Wspiera pracę z Atlassian Confluence: dokumentację techniczną, REST API, szablony, blueprinty i makra, przy układaniu runbooków inżynierskich, ADR i wiki zespołów.

Repozytorium
Agent-Skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
01.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
5
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Wspiera pracę z Atlassian Confluence: dokumentację techniczną, REST API, szablony, blueprinty i makra, przy układaniu runbooków inżynierskich, ADR i wiki zespołów.

Oryginalny opis (EN)

Expert Atlassian Confluence assistance covering technical documentation, REST APIs, templates, blueprints, and macro management. Use when structuring engineering runbooks, ADRs, and team wikis.

Jak działa

  1. When to Use
  2. Quick Start
  3. Core Concepts
  4. Common Patterns
  5. Best Practices
  6. Troubleshooting
  7. References
Sekcje z nagłówków SKILL.md, w oryginale · 149 linii, 582 słów
Podgląd SKILL.md
---
name: confluence
description: Expert Atlassian Confluence assistance covering technical documentation, REST APIs, templates, blueprints, and macro management. Use when structuring engineering runbooks, ADRs, and team wikis.
---

# Confluence

Confluence is the wiki for Jira users. It excels at **structured documentation** and deep Jira integration (embedding live Jira tables).

## When to Use

- **Enterprise Technical Documentation**: Centralizing system architecture, engineering runbooks, and design decisions.
- **Automated Documentation Publishing**: Generating Confluence pages from Markdown / CI/CD pipelines via REST API v2.
- **Atlassian Document Format (ADF)**: Creating rich structured documents with code blocks, tables, and callout macros.
- **Jira & Confluence Integration**: Linking engineering requirements to active Jira sprints and issues.

## Quick Start

```bash
# Query Confluence Cloud REST API for page content via curl
curl -X GET "https://mycompany.atlassian.net/wiki/api/v2/pages/{page-id}" \
  -u "developer@example.com:$CONFLUENCE_API_TOKEN" \
  -H "Accept: application/json" | jq '.title, .body.storage.value'
```

## Core Concepts

### Publishing Documentation via Confluence REST API v2

Creating a technical architecture page programmatically using Python:

```python
import requests
import json
import os

url = "https://your-company.atlassian.net/wiki/api/v2/pages"
auth = (os.environ["ATLASSIAN_EMAIL"], os.environ["ATLASSIAN_API_TOKEN"])
headers = {
    "Accept": "application/json",
    "Content-Type": "application/json"
}

# Storage format body (XHTML)
body_content = '''
<p>This document details the production authentication architecture.</p>
<h2>Key Components</h2>
<ul>
  <li>OAuth 2.0 / OpenID Connect Identity Provider</li>
  <li>Stateless RS256 JWT validation at Edge Ingress</li>
</ul>
<ac:structured-macro ac:name="info">
  <ac:rich-text-body>
    <p>All tokens must be signed by the corporate Keycloak realm.</p>
  </ac:rich-text-body>
</ac:structured-macro>
'''

payload = {
    "spaceId": "123456",
    "status": "current",
    "title": "Authentication Architecture Overview (2026)",
    "body": {
        "representation": "storage",
        "value": body_content
    }
}

response = requests.post(url, json=payload, headers=headers, auth=auth)
print(f"Created Page ID: {response.json().get('id')}")
```

### Searching Pages with Confluence Query Language (CQL)

Searching across spaces programmatically:

```bash
# Search for runbooks modified recently
curl -s -u "$ATLASSIAN_EMAIL:$ATLASSIAN_API_TOKEN" \
  "https://your-company.atlassian.net/wiki/rest/api/content/search?cql=space=ENG+and+title~'Runbook'+order+by+lastmodified+desc" | jq .
```

### Architecture Decision Records (ADRs)

Documenting engineering trade-offs in Confluence:

```html
<!-- Standard ADR Layout -->
<h2>Status</h2>
<p>Accepted</p>
<h2>Context</h2>
<p>
  Our monolithic database connection pool frequently exhausted under burst
  traffic.
</p>
<h2>Decision</h2>
<p>Adopted pgBouncer connection pooler in transaction pooling mode.</p>
<h2>Consequences</h2>
<p>
  Sub-millisecond connection times, but session-level prepared statements are
  restricted.
</p>
```

## Common Patterns

### Automated Page Generation via REST API

**Problem**: Manually updating release notes and deployment runbooks is time consuming and error prone.  
**Solution**: Publish documentation updates automatically using the Confluence Cloud API.

```bash
curl -X POST "https://your-domain.atlassian.net/wiki/api/v2/pages" \
  -H "Authorization: Basic $(echo -n 'user@example.com:API_TOKEN' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "spaceId": "123456",
    "status": "current",
    "title": "Release Notes v2.4.0",
    "body": {
      "representation": "storage",
      "value": "<p>Automated build artifacts deployed successfully to production.</p>"
    }
  }'
```

## Best Practices

**Do**:

- Target the modern Confluence REST API v2 for all automated documentation scripts.
- Organize engineering spaces with structured hierarchies (Architecture, Runbooks, ADRs, Postmortems).
- Automate the publication of API documentation and schemas from CI/CD pipelines to Confluence.
- Use scoped Atlassian API tokens with least privilege rather than raw user passwords.

**Don't**:

- Leave obsolete documentation active; archive pages or flag them with deprecation notices.
- Store plain credentials or internal network passwords in Confluence pages.
- Paste unformatted text; use structured macros (Code Block, Info/Warning panels, Tables).

## Troubleshooting

| Error                                       | Cause                                                   | Solution                                                                     |
| :------------------------------------------ | :------------------------------------------------------ | :--------------------------------------------------------------------------- |
| `401 Unauthorized in Confluence API`        | Using standard password instead of Atlassian API Token. | Generate API token at `id.atlassian.com/manage-profile/security/api-tokens`. |
| `403 Forbidden: Content editing restricted` | Page permissions restrict editing to specific groups.   | Request page access permissions from space administrator.                    |
| `Macro failed to render in export`          | Third-party plugin macro incompatible with PDF export.  | Replace dynamic macro with standard markdown or HTML storage format.         |

## References

- [Confluence Documentation](https://support.atlassian.com/confluence-cloud/)

Wersje

RepozytoriumWynikLicencja
Ta strona · G1Joshi/Agent-Skills100MIT
TerminalSkills/skills100Apache-2.0
odyssey4me/agent-skills100Apache-2.0
GEKI-AI/skills100Apache-2.0
alexander-tyagunov/magician100MIT
isukharev/atl100Apache-2.0
isukharev/atl100Apache-2.0
isukharev/atl100Apache-2.0
ThilinaTLM/agent-skills100MIT

Migawka bazy z 13.11.2026 · wersja paczki d6a8399b3bca (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100mcp-server-atlassian-confluence
    Instaluje i konfiguruje serwer MCP Confluence od Atlassiana, wyszukuje i tworzy dokumentację oraz wykonuje narzędzia wiki.
  • 100confluence-docs
    Dostarcza szablony dokumentacji dla ADR, runbooków i dokumentów architektury, przy tworzeniu rekordów decyzji architektonicznych, runbooków operacyjnych i dokumentacji technicznej.
  • 100confluence-docs
    Dostarcza szablony dokumentacji dla ADR, runbooków i dokumentów architektury, przy tworzeniu rekordów decyzji architektonicznych, runbooków operacyjnych i dokumentacji technicznej.
  • 100confluence-expert
    Wspiera pracę z Confluence: przestrzenie, bazy wiedzy, dokumentację, układy stron, makra, szablony i integrację Jira z Confluence, w tym strategię dokumentacji i architekturę przestrzeni.
  • 100atlassian-templates
    Tworzy, zmienia i porządkuje wielokrotnego użytku szablony, blueprinty i standardowe struktury treści w Jira i Confluence, w tym szablony organizacyjne, układy stron i automatyczne generowanie treści.
  • 100confluence-assistant
    Pełni rolę centrum operacji Confluence i kieruje prośby dotyczące wiki oraz Atlassian do wyspecjalizowanych skilli.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.