twg-space-creation
Create, design, bootstrap, or clone a whole Confluence space for any domain from a brief, existing space, repository evidence, or another source. Use for space creation or structure adaptation, not individual edits.
How do I install this agent skill?
npx skills add https://github.com/atlassian/twg-cli --skill twg-space-creationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a utility for managing Confluence spaces, authored by Atlassian. It uses the Teamwork Graph (TWG) CLI to create and organize content based on user input or repository analysis. It features a security-conscious workflow that treats external data as evidence rather than instructions, includes mandatory approval steps, and prohibits the handling of sensitive credentials.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
twg-space-creation
Use with root twg. Turn a source into an approved information architecture
and Confluence mix, then create and verify it. twg-confluence owns content
semantics and write safety; live help owns mutation grammar.
CLI launcher fallback
Run twg <command>. On shell command not found, use $HOME/.local/bin/twg
(macOS/Linux) / $env:LOCALAPPDATA\Programs\twg\bin\twg.exe (PowerShell), then
tell user to add that directory to PATH. Do not treat auth or command errors as
PATH failures.
Guiding principle
Build a navigable space, not an object quota. Favor useful hubs, ask only material questions, and show cost before substantial work.
Workflow
- Resolve. Infer target, source, purpose, audiences, and workflows. Existing spaces are same-site only; reject mismatches before source reads or writes.
- Configure. Load
references/proposal-flow.md. Ask one compact batch only for missing identity/access, scale/richness, truth-boundary, or plan/build choices. - Gather evidence. For a repository, load
references/repo-discovery.md; for an existing space, inspect its tree, instructions, and a bounded body sample. - Design. Load
references/blueprints.mdandreferences/page-archetypes.md. Present the tree, node jobs, companions, type counts, body modes/sources, instructions, exclusions, and a representative vertical slice. - Approve. A precise request that already authorizes the displayed scope may proceed. Otherwise require create/refine/cancel confirmation. Always confirm a large, ambiguous, private, or synthetic build. Approval bounds the build; it does not authorize archive, delete, overwrite, or public links.
- Create in stages. Load
references/twg-confluence-space.md. Ledger the build; set/read instructions when supported; verify one branch and one of every selected type. Expand only families matching the approved semantics. - Verify and hand off. Reconcile hierarchy, bodies, every structured/visual artifact, and supported instructions. Report URLs, counts, gaps, omitted instructions, and truncated verification.
Composition rules
- Use folders only for navigation, pages/live docs for narrative and decisions, databases for recurring structured work, whiteboards for spatial understanding. Keep time-based publishing outside space creation.
- Give each database or whiteboard an owning page; add a type only for a clear job.
- Scaffolds may use prompts, layouts, tables, and templates, but must not invent owners, decisions, dates, metrics, customer evidence, or system behavior.
- Adapt source material for its audience; choose a canonical link, synthesis, faithful import, or attachment rather than dumping a repository.
- Load
twg confluence content body-formatsjust in time for every selected authoring format. This skill never restates raw HTML, CSV, SVG, or ADF rules.
Stop conditions
Stop before writes for unresolved sites/sources, cross-site adaptation, material scope ambiguity, or proposal-only requests. Missing instructions support does not stop creation. Stop expansion on slice mismatch; never replace an unresolved parent with the space root.
References
references/proposal-flow.md— intake, space contract, approval, instructions. Load every run.references/blueprints.md— workflow-first starting shapes and scale choices.references/page-archetypes.md— rich composition by page purpose.references/repo-discovery.md— repository evidence without repo-shaped IA.references/twg-confluence-space.md— stable creation and verification flow.
Body-format syntax belongs exclusively to live body-formats guidance.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/atlassian/twg-cli/twg-space-creation">View twg-space-creation on skillZs</a>