01000001-01001110/agent-jira-skills

Overview

This skill administers Jira Cloud projects through the Jira REST API, covering creation, updates, archiving, components, versions, roles, permissions, and project properties. It provides a consistent programmatic interface for common admin tasks and supports cross-platform scripts (Node.js and Python) using a JiraClient abstraction. Use it when you need repeatable, auditable project administration or to automate release and component workflows.

How this skill works

The skill maps Jira project administration endpoints to typed operations: project CRUD, search, component management, version/release lifecycle, role and actor management, and project properties. Each operation calls the JiraClient.request wrapper and handles request parameters, query construction, and payload shapes. It includes utilities for validation (project keys) and paginated searches to safely list resources and manage changes programmatically.

When to use it

• Create, update, delete, archive, or restore Jira projects programmatically
• Manage project components, move issues, and inspect component issue counts
• Create, release, archive, or delete versions and move issues between versions
• Configure project roles, add/remove users or groups from roles
• Set, retrieve, list, or delete project-level custom properties and metadata

Best practices

• Validate project keys (2–10 uppercase letters) before creating projects to avoid API errors
• Use paginated search and startAt/maxResults when listing projects or versions to avoid large responses
• When deleting components or versions, supply move targets to preserve issue data
• Perform role changes with auditability: record actor additions/removals and verify role details afterward
• Run admin operations with an authenticated JiraClient that has the required admin permissions

Example use cases

• Automate onboarding: create a new project, add components, populate versions, and assign project lead
• Release pipeline step: mark a version as released, move unfixed issues to the next version, and archive the old version
• Cleanup script: find unused components or versions and delete or archive them while moving issues
• Permission audit: list project roles, export actors, and reconcile group membership across projects
• Bulk updates: rename projects, update descriptions, or set a common custom property across multiple projects