ScriptRunner Skills para Agentes IA
serso-pt/scriptrunner-skills
Skills para desenvolver Groovy, TypeScript e descoberta em ScriptRunner via agentes IA
Ver no GitHubConjunto de skills para agentes de IA (Claude Code, Codex, Gemini CLI, OpenCode) que permite desenvolvimento em ScriptRunner Cloud. Fornece capacidades para escrever scripts Groovy (HAPI), behaviours TypeScript e descoberta de instâncias Jira, automatizando tarefas de customização e automação em Jira.
Instalação
npx convez-ai serso-pt/scriptrunner-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar e refatorar scripts Groovy para listeners, campos customizados e funções de workflow
- Criar behaviours TypeScript para validação de campos e visibilidade dinâmica
- Descobrir e mapear IDs de campos, workflows e estruturas de dados Jira
Veredito

Ferramenta especializada e bem integrada para desenvolvimento ScriptRunner via agentes IA. Reduz fricção na codificação de customizações Jira complexas, mas exige conhecimento prévio de Groovy, TypeScript e ScriptRunner.
README
A tradução para o português deste README ainda está na fila.
ScriptRunner Skills for AI Coding Agents
Agent skills for ScriptRunner Cloud development — Groovy scripting (HAPI API), TypeScript behaviours, and Jira instance discovery.
Works with Claude Code, Codex, Gemini CLI, and OpenCode.
Skills
| Skill | Description |
|---|---|
| scriptrunner-groovy | Write/refactor Groovy scripts for listeners, script fields, jobs, escalation services, workflow post functions, conditions, validators, and additional scripts — including group management via the Atlassian Admin API |
| scriptrunner-behaviours | Write/refactor TypeScript behaviours for field visibility, validation, and template pre-filling |
| scriptrunner-discovery | Discover Jira field IDs, test JQL queries, inspect issue data structures, look up workflow IDs (transition, role, issue type, link type), and resolve Atlassian Admin org/group IDs |
Installation
OpenCode (native)
git clone https://github.com/serso-pt/scriptrunner-skills ~/.config/opencode/skills/scriptrunner-skills
On Windows (PowerShell):
git clone https://github.com/serso-pt/scriptrunner-skills "$env:USERPROFILE\.config\opencode\skills\scriptrunner-skills"
Skills are auto-discovered after restart.
Claude Code
git clone https://github.com/serso-pt/scriptrunner-skills ~/scriptrunner-skills
mkdir -p ~/.claude/skills
ln -s ~/scriptrunner-skills/skills/scriptrunner-groovy ~/.claude/skills/
ln -s ~/scriptrunner-skills/skills/scriptrunner-behaviours ~/.claude/skills/
ln -s ~/scriptrunner-skills/skills/scriptrunner-discovery ~/.claude/skills/
On Windows (PowerShell, admin):
$repo = "$env:USERPROFILE\scriptrunner-skills"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.claude\skills\scriptrunner-groovy" -Target "$repo\skills\scriptrunner-groovy"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.claude\skills\scriptrunner-behaviours" -Target "$repo\skills\scriptrunner-behaviours"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.claude\skills\scriptrunner-discovery" -Target "$repo\skills\scriptrunner-discovery"
Codex
git clone https://github.com/serso-pt/scriptrunner-skills ~/scriptrunner-skills
mkdir -p ~/.codex/skills
ln -s ~/scriptrunner-skills/skills/scriptrunner-groovy ~/.codex/skills/
ln -s ~/scriptrunner-skills/skills/scriptrunner-behaviours ~/.codex/skills/
ln -s ~/scriptrunner-skills/skills/scriptrunner-discovery ~/.codex/skills/
Gemini CLI
git clone https://github.com/serso-pt/scriptrunner-skills ~/scriptrunner-skills
mkdir -p ~/.gemini/skills
ln -s ~/scriptrunner-skills/skills/scriptrunner-groovy ~/.gemini/skills/
ln -s ~/scriptrunner-skills/skills/scriptrunner-behaviours ~/.gemini/skills/
ln -s ~/scriptrunner-skills/skills/scriptrunner-discovery ~/.gemini/skills/
Usage
After installation, restart your agent. Skills are auto-discovered — just describe your task and the agent will load the relevant skill.
Examples
See examples/ for a minimal ScriptRunner Cloud project with sample configurations:
extensions.yaml— configuration for all feature typesgroovy/CommentOnCreate.groovy— listener script using HAPI APItypescript/bugDescriptionTemplate.ts— behaviour pre-filling a bug report template on empty description
Atlassian MCP (Optional)
The Atlassian Rovo MCP server lets your AI agent query Jira directly — discover field IDs, test JQL, fetch workflow transitions, inspect issue data, and more. The scriptrunner-discovery skill prefers MCP when it's available and falls back to the REST API or the ScriptRunner Console when it isn't.
See MCP_INSTALL.md for full setup instructions covering Claude Code, OpenCode, Cline, VS Code, Cursor, and Windsurf.
Prerequisites
- A ScriptRunner Cloud-enabled Jira instance
- For
scriptrunner-discoveryMethod 1 (preferred): Atlassian MCP server — see Atlassian MCP - For
scriptrunner-discoveryMethod 2: Jira API token (REST fallback) - For
scriptrunner-discoveryMethod 3: ScriptRunner Console access (no API token needed) - For deployment: JDK 17+ and the ScriptRunner Dev & Deployment Tool
Contributing
Contributions welcome — see CONTRIBUTING.md for how to add or improve skills. This project follows our Code of Conduct.
License
MIT