atlassian/forge-skills

forge-security-review

Performs a white-box security review of Atlassian Forge apps using structured, Forge-specific security rules and evidence-driven reporting.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/atlassian/forge-skills --skill forge-security-review

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Forge Security Review

Runs a Forge-focused white-box security review and reports validated findings with exploitability, impact, evidence, and remediation guidance.

Token-Efficient Default

Use manifest-driven routing by default to reduce token usage. Do not load every rule file up front.

Rule Assets

The review rules are packaged with this skill under assets/security-rules/:

  • Global baseline: assets/security-rules/_global-forge.mdc
  • Category indexes: assets/security-rules/forge-*/_index-*.mdc
  • Category deep checks: assets/security-rules/forge-*/*.mdc

Execution Mandate

When this skill is triggered:

  1. Run static analysis first from this skill directory:
  • scripts/run_static_analysis.sh <forge-project-root-directory>
  • use .ps1 script for windows
  1. Read manifest.yml first before any deep code review.
  2. Load assets/security-rules/_global-forge.mdc first.
  3. Load only relevant category index rules based on manifest and code signals.
  4. Load deep subrules only when the matching detection heuristics are triggered by real code patterns.
  5. Perform an evidence-based security review across:
  • AuthN/AuthZ
  • Injection and input validation
  • Tenant isolation and cross-tenant leakage
  • Secrets and storage
  • Egress/remotes/CSP and manifest permissions
  • Public entry points (web triggers)
  • Agent and miscellaneous Forge security risks
  1. Do not modify app code unless the user explicitly requests fixes.
  2. Write all scan outputs and generated artifacts to security-audit-artifacts/.

Rule Routing Workflow

Phase 1: Reconnaissance (Mandatory)

Read manifest.yml first and extract:

  • permissions.scopes
  • permissions.external.fetch
  • permissions.content.scripts
  • modules (resolver/webtrigger/scheduledTrigger/rovo/etc.)
  • remotes
  • app.runtime.name

Build an execution map:

  • UI modules -> bridge calls -> resolvers/functions
  • External entry points (web triggers, events, schedules)
  • api.asUser() vs api.asApp() paths
  • Outbound fetch destinations

Phase 2: Index Rule Selection (Two-Tier Loading)

Always load first:

  • assets/security-rules/_global-forge.mdc

Then load only relevant category index rules:

SignalLoad
Any meaningful scope usage, mutations, or asApp() usageassets/security-rules/forge-authn-authz/_index-authn-authz.mdc
webtrigger or scheduledTrigger modulesassets/security-rules/forge-webtrigger-entrypoints/_index-webtrigger-entrypoints.mdc
permissions.external.fetch or remotesassets/security-rules/forge-egress-remotes/_index-egress-remotes.mdc
SQL APIs or untrusted input reaching resolver sinksassets/security-rules/forge-injection/_index-injection.mdc
Multi-tenant patterns, module/global state, cache reuseassets/security-rules/forge-tenant-isolation/_index-tenant-isolation.mdc
Credentials/tokens/secrets handlingassets/security-rules/forge-secrets-storage/_index-secrets-storage.mdc
Unsafe CSP or likely scope/config misconfigurationassets/security-rules/forge-manifest-config/_index-manifest-config.mdc
Rovo modules/actionsassets/security-rules/forge-rovo-agents/_index-rovo-agents.mdc
Baseline logging/error/static analysis concernsassets/security-rules/forge-auditing/_index-auditing.mdc
Dependency/package risk reviewassets/security-rules/forge-misc/_index-misc.mdc

Subrule policy:

  • After reading an index, load only the subrules that match the detection heuristics observed in code.
  • Do not pre-load every subrule in a category.

Phase 3: Analysis and Verification

For each loaded category:

  1. Enumerate reachable entry points.
  2. Trace source -> validation/authz -> sink.
  3. Confirm exploitability with evidence.
  4. Score confirmed findings with CVSS v3.1.

Focused Review Mode

If the user asks for a narrow review (for example, only authz), load:

  • Global baseline
  • Requested category index
  • Only matching subrules in that category

Still mention any obvious critical findings observed outside scope.

Review Workflow

  1. Build an execution map:
  • UI Kit/Custom UI entry points
  • Bridge invocations and resolver handlers
  • api.asUser() / api.asApp() call paths
  • External egress/remotes and trigger entry points
  1. For each finding, trace source -> validation/authz -> sink.
  2. Validate exploitability before classifying as a confirmed vulnerability.
  3. Keep non-exploitable hardening observations in a separate "needs validation" section.
  4. Provide file-level evidence and practical test leads for each issue.

Static Analysis Mode

If the user asks for a full scan, run the complete workflow from:

  • assets/security-rules/forge-auditing/static-analysis-forge.mdc

Expected tools (when available): Semgrep, npm audit, Snyk, gitleaks.

Output Requirements

  • Provide a markdown security audit report.
  • Order confirmed exploitable findings by CVSS v3.1 severity and impact.
  • Include for each confirmed finding:
  • CVSS vector and base score
  • Severity band
  • Exploitability and impact
  • File evidence and source-to-sink trace
  • CWE mapping
  • Reproducible PoC/test steps with concrete commands
  • Include assumptions and evidence gaps.
  • Do not report scanner counts only when vulnerabilities exist.

Example Trigger Phrases

  • "Review this Forge app for security"
  • "Do a white-box security audit of my Forge app"
  • "Check this app for authz bypass and tenant isolation issues"
  • "Run full static analysis for this Forge codebase"

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
atlassian
Comunidad

forge-app-review

Performs a lightweight pre-release readiness review of Atlassian Forge apps across manifest/module wiring, architecture, runtime compatibility, dependency posture, tests, deploy readiness, and obvious security, cost, or reliability smells. Use when the user asks "review my Forge app", "pre-deploy check", "is this app ready to ship", "review manifest", "general app review", "release readiness", or asks for a broad quality pass. Do not use for deep security audits/SAST/exploitability review, cost

instalaciones
0
GitHub Stars
27
Actualizado
20 oct
atlassian
Comunidad

forge-cost-optimizer

Optimizes Atlassian Forge apps to reduce platform consumption and avoid unnecessary costs using Atlassian's "Optimise Forge platform costs" guidance. Use when the user asks to optimize Forge app costs, reduce Forge invocations, lower GB-seconds, reduce storage or log usage, tune memory, replace polling, improve scheduled triggers, reduce KVS writes, move work to the frontend, use bridge APIs, batch API calls, add caching, or evaluate Forge Remote trade-offs. By default, perform an audit first an

instalaciones
0
GitHub Stars
27
Actualizado
20 oct
atlassian
Comunidad

forge-app-builder

Plan, build, scaffold, or safely extend Atlassian Forge apps using current official documentation. Use for fresh Forge apps, existing-app feature work, module and manifest changes, UI Kit or Custom UI implementation, backend functions and events, Atlassian or external APIs, storage, permissions, environment configuration, distribution-affecting implementation, validation, and explicitly authorized deployment or installation; route standalone debugging and specialist reviews to their dedicated sk

instalaciones
1
GitHub Stars
25
Actualizado
20 oct
atlassian
Comunidad

forge-onboarding

Guide a first-time Forge builder through deploying a stock Rovo Agent, then turning it into Forge Guru, a documentation companion. Use for Forge onboarding, a first Forge or Rovo app, or resuming this tutorial. Route unrelated existing-app changes, debugging, reviews, and connector work to the specialist skills.

instalaciones
1
GitHub Stars
25
Actualizado
20 oct