stefano
251148c3ff
## Summary - add repository-wide quality tooling and verification scaffolding, including CI workflows, pnpm workspace setup, ESLint/Prettier/markdown checks, and generated-output verification helpers - reorganize skill sources and generation flow by introducing canonical `_source` variants, generator/manifests, reusable helper abstractions, and shared web-automation/browser utilities - clean up and expand documentation so the root README flows into docs and skill docs, with clearer development, reviewer, installer, and workflow guidance ## Notable changes - docs flow and consistency cleanup across `README.md`, `docs/README.md`, and related docs - new scripts for `check`, docs verification, generated-file verification, shell portability, and safe directory replacement - refactors in Atlassian and web-automation skill runtimes to reduce duplication and centralize reusable code - changelog, development documentation, and CI surface updates ## Test Plan - [ ] `pnpm run check` - [ ] review generated/manifests and skill sync outputs - [ ] smoke-check docs flow from `README.md` to `docs/README.md` to skill docs ## Notes - this branch currently includes tracked `skills/web-automation/shared/node_modules` content that should be reviewed carefully as potentially noisy/accidental committed artifacts Co-authored-by: Stefano Fiorini <stefano.fiorini@firsthorizon.com> Reviewed-on: #1
3.4 KiB
3.4 KiB
name, description
| name | description |
|---|---|
| atlassian | Interact with Atlassian Cloud Jira and Confluence through a portable task-oriented CLI for search, issue/page edits, comments, transitions, and bounded raw requests. |
Atlassian (Cursor Agent CLI)
Portable Atlassian workflows for Cursor Agent CLI using a shared TypeScript CLI.
Requirements
- Cursor Agent CLI skill discovery via
.cursor/skills/or~/.cursor/skills/ - Node.js 20+
pnpm- Atlassian Cloud account access
ATLASSIAN_BASE_URLATLASSIAN_EMAILATLASSIAN_API_TOKEN
The ATLASSIAN_* values may come from the shell environment or a .env file in the installed scripts/ folder.
First-Time Setup
Repo-local install:
mkdir -p .cursor/skills/atlassian
cp -R skills/atlassian/cursor/* .cursor/skills/atlassian/
cd .cursor/skills/atlassian/scripts
pnpm install
Global install:
mkdir -p ~/.cursor/skills/atlassian
cp -R skills/atlassian/cursor/* ~/.cursor/skills/atlassian/
cd ~/.cursor/skills/atlassian/scripts
pnpm install
Prerequisite Check (MANDATORY)
Repo-local form:
cursor-agent --version
cd .cursor/skills/atlassian/scripts
node -e "require.resolve('commander');require.resolve('dotenv');console.log('OK: runtime dependencies installed')"
node -e 'require("dotenv").config({ path: ".env" }); const required = ["ATLASSIAN_BASE_URL", "ATLASSIAN_EMAIL", "ATLASSIAN_API_TOKEN"]; const missing = required.filter((key) => !(process.env[key] || "").trim()); if (missing.length) { console.error("Missing required Atlassian config: " + missing.join(", ")); process.exit(1); } console.log("OK: Atlassian config present")'
pnpm atlassian health
If any check fails, stop and return:
Missing dependency/config: atlassian requires installed CLI dependencies and valid Atlassian Cloud credentials. Configure ATLASSIAN_* in the shell environment or scripts/.env, then retry.
Supported Commands
pnpm atlassian healthpnpm atlassian jira-search --jql "..."pnpm atlassian jira-get --issue ABC-123pnpm atlassian jira-create ... [--dry-run]pnpm atlassian jira-update ... [--dry-run]pnpm atlassian jira-comment ... [--dry-run]pnpm atlassian jira-transitions --issue ABC-123pnpm atlassian jira-transition ... [--dry-run]pnpm atlassian conf-search --query "..."pnpm atlassian conf-get --page 12345pnpm atlassian conf-create ... [--dry-run]pnpm atlassian conf-update ... [--dry-run]pnpm atlassian conf-comment ... [--dry-run]pnpm atlassian conf-children --page 12345pnpm atlassian raw --product jira|confluence --method GET|POST|PUT --path ...
Usage Examples
pnpm atlassian jira-get --issue ENG-123pnpm atlassian conf-search --query "title ~ \\\"Runbook\\\"" --max-results 10 --start-at 0pnpm atlassian raw --product confluence --method POST --path "/wiki/api/v2/pages" --body-file page.json --dry-run
Safety Rules
- Prefer JSON output for agent use.
- Use
--dry-runbefore writes unless the user explicitly wants the change applied. - Keep
--body-fileinputs within the current workspace. - Use
rawonly for user-requested unsupported endpoints. rawdoes not allowDELETE.
Notes
- Cursor discovers this skill from
.cursor/skills/or~/.cursor/skills/. - Atlassian Cloud is the supported platform in v1.