CtrlK
BlogDocsLog inGet started
Tessl Logo

jira-spaces

Manage Confluence spaces for project documentation. Create, list, and delete spaces with templates. Use when setting up project documentation structure or managing Confluence content areas.

Install with Tessl CLI

npx tessl i github:NeverSight/skills_feed --skill jira-spaces
What are skills?

80

Quality

75%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Optimize this skill with Tessl

npx tessl skill review --optimize ./data/skills-md/01000001-01001110/agent-jira-skills/jira-spaces/SKILL.md
SKILL.md
Review
Evals

Jira Spaces Skill

Manage Confluence spaces through the Confluence Cloud REST API. Spaces are the top-level containers for organizing project documentation, wikis, and knowledge bases.

When to Use

  • Setting up documentation structure for a new project
  • Creating spaces for different teams or initiatives
  • Listing available spaces to find documentation
  • Archiving or deleting obsolete spaces

Prerequisites

  • Confluence Cloud instance (same Atlassian account as Jira)
  • API token with Confluence access
  • Environment variables configured in .env

API Reference

Base URL

Confluence Cloud uses the same base URL as Jira Cloud but different API path:

https://your-domain.atlassian.net/wiki/rest/api

Authentication

Same as Jira - Basic Auth with email:token.

Key Endpoints

EndpointMethodDescription
/spaceGETList all spaces
/spacePOSTCreate a new space
/space/{spaceKey}GETGet space details
/space/{spaceKey}DELETEDelete a space
/space/{spaceKey}/contentGETList space content

Space Types

TypeDescriptionUse Case
globalSite-wide spaceCompany wikis, shared docs
personalUser's personal spaceIndividual notes, drafts

Creating a Space

Request

const response = await fetch(`${CONFLUENCE_URL}/wiki/rest/api/space`, {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${auth}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    key: 'PROJ',           // Unique space key (uppercase)
    name: 'Project Docs',   // Display name
    type: 'global',         // 'global' or 'personal'
    description: {
      plain: {
        value: 'Documentation for the project',
        representation: 'plain'
      }
    }
  })
});

Response

{
  "id": 12345,
  "key": "PROJ",
  "name": "Project Docs",
  "type": "global",
  "status": "current",
  "_links": {
    "webui": "/spaces/PROJ",
    "self": "https://your-domain.atlassian.net/wiki/rest/api/space/PROJ"
  }
}

Listing Spaces

Request

const response = await fetch(`${CONFLUENCE_URL}/wiki/rest/api/space?limit=25&type=global`, {
  headers: {
    'Authorization': `Basic ${auth}`,
    'Accept': 'application/json'
  }
});

Response

{
  "results": [
    {
      "id": 12345,
      "key": "PROJ",
      "name": "Project Docs",
      "type": "global",
      "status": "current"
    }
  ],
  "start": 0,
  "limit": 25,
  "size": 1,
  "_links": {}
}

Deleting a Space

WARNING: Deleting a space removes all pages and content permanently!

Request

const response = await fetch(`${CONFLUENCE_URL}/wiki/rest/api/space/PROJ`, {
  method: 'DELETE',
  headers: {
    'Authorization': `Basic ${auth}`
  }
});

Returns 202 Accepted (deletion is async) or 204 No Content.

Space Keys

Space keys must:

  • Be unique across the Confluence instance
  • Use only uppercase letters and numbers
  • Be 1-255 characters
  • Not start with a number

Conventions:

  • PROJ - Project-specific
  • TEAM - Team-specific
  • DOC - Documentation
  • KB - Knowledge base

Common Patterns

Create Project Documentation Space

// Create space with home page
await createSpace({
  key: 'TUSTLE',
  name: 'Tustle Project Documentation',
  description: 'Technical documentation and guides for Tustle MVP'
});

// Add standard pages
await createPage('TUSTLE', 'Getting Started', 'Overview and setup instructions...');
await createPage('TUSTLE', 'Architecture', 'System architecture documentation...');
await createPage('TUSTLE', 'API Reference', 'API endpoint documentation...');

List Team Spaces

const spaces = await listSpaces({ type: 'global', limit: 50 });
const teamSpaces = spaces.filter(s => s.name.includes('Team'));

Error Handling

StatusMeaningResolution
400Invalid space keyCheck key format (uppercase, no special chars)
401UnauthorizedCheck API token and email
403ForbiddenUser lacks space admin permissions
404Space not foundVerify space key exists
409ConflictSpace key already exists

Scripts

ScriptDescription
create-spaceCreate a new Confluence space
delete-spaceDelete a space (with confirmation)
list-spacesList all accessible spaces

Usage Examples

# List all spaces
node run.js list-spaces

# Create a new space
node run.js create-space DOCS "Documentation Space"

# Delete a space (interactive confirmation)
node run.js delete-space DOCS

# Force delete without confirmation
node run.js delete-space DOCS --confirm

Related Skills

  • jira-projects - Jira project management
  • jira-issues - Issue creation for documentation tasks
Repository
NeverSight/skills_feed
Commit

80215e3

Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill