{
  "schemaVersion": "1.0",
  "item": {
    "slug": "atlassian-cli",
    "name": "Atlassian aCLI Reference Skill for Jira and Confluence",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/peetzweg/atlassian-cli",
    "canonicalUrl": "https://clawhub.ai/peetzweg/atlassian-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/atlassian-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=atlassian-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/other-commands.md",
      "references/jira-workitem-commands.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "atlassian-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T06:09:31.100Z",
      "expiresAt": "2026-05-07T06:09:31.100Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=atlassian-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=atlassian-cli",
        "contentDisposition": "attachment; filename=\"atlassian-cli-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "atlassian-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/atlassian-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/atlassian-cli",
    "agentPageUrl": "https://openagent3.xyz/skills/atlassian-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/atlassian-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/atlassian-cli/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Prerequisites",
        "body": "This skill requires acli to be installed and authenticated. The binary is NOT bundled with this skill.\n\nIf acli is not installed, guide the user to: https://developer.atlassian.com/cloud/acli/guides/install-acli/\n\nVerify availability:\n\nacli --help"
      },
      {
        "title": "Authentication",
        "body": "Check auth status before running commands:\n\nacli jira auth status\nacli admin auth status\n\nIf not authenticated, there are three methods:\n\nOAuth (interactive, recommended for users):\n\nacli jira auth login --web\n\nAPI Token (non-interactive, recommended for CI/automation):\n\necho \"$API_TOKEN\" | acli jira auth login --site \"mysite.atlassian.net\" --email \"user@atlassian.com\" --token\n\nAdmin API Key (for admin commands only):\n\necho \"$API_KEY\" | acli admin auth login --email \"admin@atlassian.com\" --token\n\nSwitch between accounts:\n\nacli jira auth switch --site mysite.atlassian.net --email user@atlassian.com\nacli admin auth switch --org myorgname"
      },
      {
        "title": "Secret Handling",
        "body": "Never hardcode tokens or API keys in commands. Always use environment variables ($API_TOKEN, $API_KEY) or file-based input (< token.txt).\nNever log, echo, or display tokens in output. Avoid piping secrets through intermediate files that persist on disk.\nPrefer OAuth (--web) for interactive use. Only use token-based auth for CI/automation where OAuth is not feasible.\nDo not store tokens in shell history. If using echo \"$API_TOKEN\" | acli ..., ensure the variable is set in the environment rather than inlined as a literal value."
      },
      {
        "title": "Destructive Operations",
        "body": "The following commands are destructive or irreversible — always confirm with the user before executing:\n\nacli jira workitem delete — permanently deletes work items\nacli jira project delete — permanently deletes a project and all its work items\nacli admin user delete — deletes managed user accounts\nacli admin user deactivate — deactivates user accounts\nacli jira field delete — moves custom fields to trash\n\nThese commands are impactful but reversible:\n\nacli jira workitem archive / unarchive\nacli jira project archive / restore\nacli admin user cancel-delete — cancels pending deletion\nacli jira field cancel-delete — restores field from trash\n\nAgent safety rules:\n\nNever run destructive commands without explicit user confirmation, even if --yes is available.\nWhen bulk-targeting via --jql or --filter, first run a search with the same query to show the user what will be affected.\nPrefer --json output to verify targets before applying destructive changes.\nDo not combine --yes with destructive bulk operations unless the user explicitly requests unattended execution."
      },
      {
        "title": "Command Structure",
        "body": "acli <command> [<subcommand> ...] {MANDATORY FLAGS} [OPTIONAL FLAGS]\n\nFour top-level command groups:\n\nacli jira - Jira Cloud operations (workitems, projects, boards, sprints, filters, dashboards, fields)\nacli admin - Organization administration (user management, auth)\nacli rovodev - Rovo Dev AI coding agent (Beta)\nacli feedback - Submit feedback/bug reports"
      },
      {
        "title": "Output Formats",
        "body": "Most list/search commands support: --json, --csv, and default table output."
      },
      {
        "title": "Bulk Operations",
        "body": "Target multiple items via:\n\n--key \"KEY-1,KEY-2,KEY-3\" - comma-separated keys\n--jql \"project = TEAM AND status = 'To Do'\" - JQL query\n--filter 10001 - saved filter ID\n--from-file \"items.txt\" - file with keys/IDs (comma/whitespace/newline separated)\n\nUse --ignore-errors to continue past failures in bulk operations.\nUse --yes / -y to skip confirmation prompts (useful for automation)."
      },
      {
        "title": "Pagination",
        "body": "--limit N - max items to return (defaults vary: 30-50)\n--paginate - fetch all pages automatically (overrides --limit)"
      },
      {
        "title": "JSON Templates",
        "body": "Many create/edit commands support --generate-json to produce a template, and --from-json to consume it:\n\nacli jira workitem create --generate-json > template.json\n# edit template.json\nacli jira workitem create --from-json template.json"
      },
      {
        "title": "Work Items",
        "body": "# Create\nacli jira workitem create --summary \"Fix login bug\" --project \"TEAM\" --type \"Bug\"\nacli jira workitem create --summary \"New feature\" --project \"TEAM\" --type \"Story\" --assignee \"@me\" --label \"frontend,p1\"\n\n# Search\nacli jira workitem search --jql \"project = TEAM AND assignee = currentUser()\" --json\nacli jira workitem search --jql \"project = TEAM AND status = 'In Progress'\" --fields \"key,summary,assignee\" --csv\n\n# View\nacli jira workitem view KEY-123\nacli jira workitem view KEY-123 --json --fields \"*all\"\n\n# Edit\nacli jira workitem edit --key \"KEY-123\" --summary \"Updated title\" --assignee \"user@atlassian.com\"\n\n# Transition\nacli jira workitem transition --key \"KEY-123\" --status \"Done\"\nacli jira workitem transition --jql \"project = TEAM AND sprint in openSprints()\" --status \"In Progress\"\n\n# Assign\nacli jira workitem assign --key \"KEY-123\" --assignee \"@me\"\n\n# Comment\nacli jira workitem comment create --key \"KEY-123\" --body \"Work completed\"\n\n# Bulk create\nacli jira workitem create-bulk --from-csv issues.csv"
      },
      {
        "title": "Projects",
        "body": "acli jira project list --paginate --json\nacli jira project view --key \"TEAM\" --json\nacli jira project create --from-project \"TEAM\" --key \"NEW\" --name \"New Project\""
      },
      {
        "title": "Boards & Sprints",
        "body": "acli jira board search --project \"TEAM\"\nacli jira board list-sprints --id 123 --state active\nacli jira sprint list-workitems --sprint 1 --board 6"
      },
      {
        "title": "Detailed Command Reference",
        "body": "For complete flag details, parameters, and examples for every command:\n\nJira work item commands (create, edit, search, assign, transition, comment, clone, link, archive, attachment, watcher): See references/jira-workitem-commands.md\nAll other commands (jira project/board/sprint/filter/dashboard/field, admin, rovodev, feedback): See references/other-commands.md"
      }
    ],
    "body": "Atlassian CLI (acli) Reference\nPrerequisites\n\nThis skill requires acli to be installed and authenticated. The binary is NOT bundled with this skill.\n\nIf acli is not installed, guide the user to: https://developer.atlassian.com/cloud/acli/guides/install-acli/\n\nVerify availability:\n\nacli --help\n\nAuthentication\n\nCheck auth status before running commands:\n\nacli jira auth status\nacli admin auth status\n\n\nIf not authenticated, there are three methods:\n\nOAuth (interactive, recommended for users):\n\nacli jira auth login --web\n\n\nAPI Token (non-interactive, recommended for CI/automation):\n\necho \"$API_TOKEN\" | acli jira auth login --site \"mysite.atlassian.net\" --email \"user@atlassian.com\" --token\n\n\nAdmin API Key (for admin commands only):\n\necho \"$API_KEY\" | acli admin auth login --email \"admin@atlassian.com\" --token\n\n\nSwitch between accounts:\n\nacli jira auth switch --site mysite.atlassian.net --email user@atlassian.com\nacli admin auth switch --org myorgname\n\nSecurity\nSecret Handling\nNever hardcode tokens or API keys in commands. Always use environment variables ($API_TOKEN, $API_KEY) or file-based input (< token.txt).\nNever log, echo, or display tokens in output. Avoid piping secrets through intermediate files that persist on disk.\nPrefer OAuth (--web) for interactive use. Only use token-based auth for CI/automation where OAuth is not feasible.\nDo not store tokens in shell history. If using echo \"$API_TOKEN\" | acli ..., ensure the variable is set in the environment rather than inlined as a literal value.\nDestructive Operations\n\nThe following commands are destructive or irreversible — always confirm with the user before executing:\n\nacli jira workitem delete — permanently deletes work items\nacli jira project delete — permanently deletes a project and all its work items\nacli admin user delete — deletes managed user accounts\nacli admin user deactivate — deactivates user accounts\nacli jira field delete — moves custom fields to trash\n\nThese commands are impactful but reversible:\n\nacli jira workitem archive / unarchive\nacli jira project archive / restore\nacli admin user cancel-delete — cancels pending deletion\nacli jira field cancel-delete — restores field from trash\n\nAgent safety rules:\n\nNever run destructive commands without explicit user confirmation, even if --yes is available.\nWhen bulk-targeting via --jql or --filter, first run a search with the same query to show the user what will be affected.\nPrefer --json output to verify targets before applying destructive changes.\nDo not combine --yes with destructive bulk operations unless the user explicitly requests unattended execution.\nCommand Structure\nacli <command> [<subcommand> ...] {MANDATORY FLAGS} [OPTIONAL FLAGS]\n\n\nFour top-level command groups:\n\nacli jira - Jira Cloud operations (workitems, projects, boards, sprints, filters, dashboards, fields)\nacli admin - Organization administration (user management, auth)\nacli rovodev - Rovo Dev AI coding agent (Beta)\nacli feedback - Submit feedback/bug reports\nCommon Patterns\nOutput Formats\n\nMost list/search commands support: --json, --csv, and default table output.\n\nBulk Operations\n\nTarget multiple items via:\n\n--key \"KEY-1,KEY-2,KEY-3\" - comma-separated keys\n--jql \"project = TEAM AND status = 'To Do'\" - JQL query\n--filter 10001 - saved filter ID\n--from-file \"items.txt\" - file with keys/IDs (comma/whitespace/newline separated)\n\nUse --ignore-errors to continue past failures in bulk operations. Use --yes / -y to skip confirmation prompts (useful for automation).\n\nPagination\n--limit N - max items to return (defaults vary: 30-50)\n--paginate - fetch all pages automatically (overrides --limit)\nJSON Templates\n\nMany create/edit commands support --generate-json to produce a template, and --from-json to consume it:\n\nacli jira workitem create --generate-json > template.json\n# edit template.json\nacli jira workitem create --from-json template.json\n\nQuick Reference: Most Common Operations\nWork Items\n# Create\nacli jira workitem create --summary \"Fix login bug\" --project \"TEAM\" --type \"Bug\"\nacli jira workitem create --summary \"New feature\" --project \"TEAM\" --type \"Story\" --assignee \"@me\" --label \"frontend,p1\"\n\n# Search\nacli jira workitem search --jql \"project = TEAM AND assignee = currentUser()\" --json\nacli jira workitem search --jql \"project = TEAM AND status = 'In Progress'\" --fields \"key,summary,assignee\" --csv\n\n# View\nacli jira workitem view KEY-123\nacli jira workitem view KEY-123 --json --fields \"*all\"\n\n# Edit\nacli jira workitem edit --key \"KEY-123\" --summary \"Updated title\" --assignee \"user@atlassian.com\"\n\n# Transition\nacli jira workitem transition --key \"KEY-123\" --status \"Done\"\nacli jira workitem transition --jql \"project = TEAM AND sprint in openSprints()\" --status \"In Progress\"\n\n# Assign\nacli jira workitem assign --key \"KEY-123\" --assignee \"@me\"\n\n# Comment\nacli jira workitem comment create --key \"KEY-123\" --body \"Work completed\"\n\n# Bulk create\nacli jira workitem create-bulk --from-csv issues.csv\n\nProjects\nacli jira project list --paginate --json\nacli jira project view --key \"TEAM\" --json\nacli jira project create --from-project \"TEAM\" --key \"NEW\" --name \"New Project\"\n\nBoards & Sprints\nacli jira board search --project \"TEAM\"\nacli jira board list-sprints --id 123 --state active\nacli jira sprint list-workitems --sprint 1 --board 6\n\nDetailed Command Reference\n\nFor complete flag details, parameters, and examples for every command:\n\nJira work item commands (create, edit, search, assign, transition, comment, clone, link, archive, attachment, watcher): See references/jira-workitem-commands.md\nAll other commands (jira project/board/sprint/filter/dashboard/field, admin, rovodev, feedback): See references/other-commands.md"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/peetzweg/atlassian-cli",
    "publisherUrl": "https://clawhub.ai/peetzweg/atlassian-cli",
    "owner": "peetzweg",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/atlassian-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/atlassian-cli",
    "agentUrl": "https://openagent3.xyz/skills/atlassian-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/atlassian-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/atlassian-cli/agent.md"
  }
}