Skill: nerdcuba/jira-cloud-admin (version 1.0.1)

--- name: jira-admin-cloud description: "Jira Cloud admin playbook. Use for Jira Cloud administration tasks: projects (company-managed/team-managed), permissions, workflows, fields/screens, automation, JSM setup (queues/SLAs/portals), reporting/dashboards, and Confluence integrations. Includes official Atlassian references and best-practice checklists in ES/EN." --- # Jira Admin Cloud (Phase 1) ## What this skill does - Practical guide for **Jira Cloud** administration (includes JSM and Confluence). - Module checklists and official references. - Respond in **ES/EN** as requested by the user. ## Recommended flow (fast) 1) Identify **project type**: Company-managed vs Team-managed. 2) Define the user goal (permissions / workflow / fields / automation / JSM / reports). 3) Use the **module checklist** in `references/`. 4) If more detail is required, open Atlassian official docs. ## Modules & references - **Atlassian base** → `references/atlassian-cloud-links.md` - **Checklists** → `references/checklists.md` - **JSM** → `references/jsm-links.md` - **Confluence** → `references/confluence-links.md` - **Experts** → `references/experts-links.md` ## Key checklists (summary) - **Permissions**: roles vs permissions, schemes, groups, granularity. - **Workflows**: statuses, transitions, validators, post-functions, conditions. - **Fields/Screens**: contexts, screens, required fields, global impact. - **Automation**: project/global rules, limits, audit. - **JSM**: request types, SLAs, queues, portal. - **Reporting**: shared filters, dashboards, gadgets. ## Notes - Always prioritize **Jira Cloud** (not Data Center). - Use **official Atlassian sources** for confirmation. - Keep answers concise and actionable.

path: references/atlassian-cloud-links.md
content: # Atlassian Jira Cloud — enlaces oficiales (ES/EN)

## Jira Cloud (Admin)
- Admin hub: https://admin.atlassian.com/
- Jira Cloud admin overview (EN): https://support.atlassian.com/jira-cloud-administration/
- Jira Cloud admin overview (ES): https://support.atlassian.com/es/jira-cloud-administration/

## Projects
- Company-managed projects (EN): https://support.atlassian.com/jira-cloud-administration/docs/what-are-company-managed-projects/
- Team-managed projects (EN): https://support.atlassian.com/jira-cloud-administration/docs/what-are-team-managed-projects/

## Permissions & roles
- Permissions overview (EN): https://support.atlassian.com/jira-cloud-administration/docs/permissions-overview/
- Permission schemes (EN): https://support.atlassian.com/jira-cloud-administration/docs/manage-permission-schemes/
- Project roles (EN): https://support.atlassian.com/jira-cloud-administration/docs/manage-project-roles/

## Workflows
- Workflows overview (EN): https://support.atlassian.com/jira-cloud-administration/docs/manage-workflows/
- Workflow statuses (EN): https://support.atlassian.com/jira-cloud-administration/docs/working-with-workflows/

## Fields & screens
- Custom fields (EN): https://support.atlassian.com/jira-cloud-administration/docs/manage-custom-fields/
- Screens (EN): https://support.atlassian.com/jira-cloud-administration/docs/manage-screens/
- Field contexts (EN): https://support.atlassian.com/jira-cloud-administration/docs/manage-custom-field-contexts/

## Automation
- Automation overview (EN): https://support.atlassian.com/cloud-automation/docs/jira-automation/
- Automation limits (EN): https://support.atlassian.com/cloud-automation/docs/automation-usage-limits/

## Reporting
- Dashboards (EN): https://support.atlassian.com/jira-cloud-administration/docs/view-and-create-dashboards/
- Filters (EN): https://support.atlassian.com/jira-software-cloud/docs/manage-filters/


path: references/automation-advanced.md
content: # Automatización Jira Cloud — avanzado

## Buenas prácticas
- Definir **scope** (global vs proyecto) y propietario de la regla.
- Añadir **guardrails** (labels/issueType) para evitar loops.
- Usar `re-fetch issue data` en transiciones complejas.
- Monitorizar **audit log** y límites de ejecución.

## Patrones comunes
- SLA/tiempos: cambios de prioridad → reajustar fechas objetivo.
- Handoff: al pasar a “En QA” asignar reviewer automático.
- Notificaciones: solo cuando cambia estado crítico.

## Límites
- Revisar cuota de automatización por plan.
- Evitar reglas en cadena (posibles loops).


path: references/checklists.md
content: # Checklists — Jira Cloud Admin

## 1) Proyectos (Company vs Team)
- Confirmar tipo de proyecto y limitaciones
- Revisar configuración de roles/miembros
- Verificar esquema asociado (si aplica)

## 2) Permisos
- ¿Quién necesita qué? (create/edit/transition)
- Revisar esquema de permisos y grupos
- Evitar permisos globales innecesarios

## 3) Workflows
- Estados mínimos necesarios
- Transiciones con condiciones/validadores
- Post-funciones sólo si aportan valor

## 4) Campos y pantallas
- Evitar campos globales sin contexto
- Revisar screens por tipo de issue
- Marcar campos requeridos con criterio

## 5) Automatización
- Definir objetivo claro de la regla
- Probar en un proyecto sandbox
- Revisar límites y auditoría

## 6) JSM (Servicio)
- Tipos de solicitud y formularios
- SLAs definidos y medibles
- Colas útiles para operación

## 7) Reportes
- Filtros compartidos con permisos
- Dashboards por equipo
- Gadgets accionables


path: references/confluence-links.md
content: # Confluence Cloud — enlaces oficiales

- Confluence Cloud help (EN): https://support.atlassian.com/confluence-cloud/
- Confluence Cloud help (ES): https://support.atlassian.com/es/confluence-cloud/

## Spaces & permissions
- Spaces overview (EN): https://support.atlassian.com/confluence-cloud/docs/what-are-spaces/
- Space permissions (EN): https://support.atlassian.com/confluence-cloud/docs/assign-space-permissions/

## Jira + Confluence
- Link Confluence to Jira (EN): https://support.atlassian.com/confluence-cloud/docs/insert-jira-issues-into-confluence/
- Jira/Confluence integration (EN): https://support.atlassian.com/confluence-cloud/docs/use-jira-issues-in-confluence/


path: references/experts-links.md
content: # Especialistas / mejores prácticas — Jira Cloud

> Nota: priorizar fuentes oficiales de Atlassian y partners reconocidos.

## Atlassian Community
- https://community.atlassian.com/
- Jira Administration tag: https://community.atlassian.com/t5/Jira-questions/qa-p/jira-questions

## Partners / Consultoras
- Adaptavist (EN): https://www.adaptavist.com/blog
- Appfire (EN): https://appfire.com/resources/blog
- K15t (EN): https://www.k15t.com/blog
- Atlassian Blog (EN): https://www.atlassian.com/blog

## Recursos de buenas prácticas
- Jira Cloud best practices (EN): https://www.atlassian.com/software/jira/guides
- Jira Service Management guides (EN): https://www.atlassian.com/software/jira/service-management/guides


path: references/jsm-links.md
content: # Jira Service Management (Cloud) — enlaces oficiales

## Overview
- JSM Cloud admin (EN): https://support.atlassian.com/jira-service-management-cloud/
- JSM Cloud admin (ES): https://support.atlassian.com/es/jira-service-management-cloud/

## Portals & request types
- Customer portals (EN): https://support.atlassian.com/jira-service-management-cloud/docs/customize-your-portal/
- Request types (EN): https://support.atlassian.com/jira-service-management-cloud/docs/create-request-types/

## SLAs
- SLAs overview (EN): https://support.atlassian.com/jira-service-management-cloud/docs/set-up-service-level-agreements/

## Queues
- Queues (EN): https://support.atlassian.com/jira-service-management-cloud/docs/create-queues/

## Knowledge base
- Link to Confluence KB (EN): https://support.atlassian.com/jira-service-management-cloud/docs/link-a-confluence-space-to-your-service-project/


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)