К основному содержанию
скилл CX Codex

forge-onboarding — скилл для Claude Code: что делает и как установить

Скилл forge-onboarding для Claude Code и Codex пошагово проводит через создание и деплой агента Forge Guru. Запускается при первом знакомстве с Atlassian Forge или Rovo.

Apache-2.0 173 установок ★ 33 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add atlassian/forge-skills --skill forge-onboarding -a claude-code
Открыть на GitHub

Что делает forge-onboarding

Скилл ведёт разработчика по пяти фазам: от приветствия и сбора настроек до сборки, развёртывания и проверки живого агента Rovo на тестовом сайте Atlassian. Он не вываливает документацию сразу, а подгружает нужный контекст только под текущий шаг: welcome, setup, build, celebrate или next-steps.

Процесс спроектирован без лишних пауз. Вместо постоянных вопросов скилл берёт одно пакетное подтверждение в конце фазы setup сразу на четыре действия: генерацию файлов, перенос ресурсов Guru, деплой в development и установку на сайт. Секреты и токены в чат не попадают — авторизация выполняется в интерактивном терминале пользователя.

Для генерации приложения скиллу требуется Python (команда python3 или проверенный python), через который запускается вспомогательный скрипт scripts.create_forge_app из соседнего пакета forge-app-builder. Также понадобится установленный Forge CLI и тестовый сайт Atlassian Cloud. Любые задачи вне первого знакомства — отладку или правку существующих приложений — скилл передаёт специализированным инструментам.

Какие задачи решает

  • развернуть первого агента Rovo (Forge Guru) с нуля без чтения всей документации Forge
  • проверить окружение, версии Node, Forge CLI и доступы к Atlassian Developer Space
  • создать каркас проекта Forge через forge create с сохранением существующих файлов
  • выполнить единое пакетное подтверждение на сборку, деплой в development и установку на тестовый сайт
  • проверить работу агента реальным вопросом после завершения деплоя

Примеры запросов агенту

  • Помоги создать первое приложение на Atlassian Forge
  • Хочу собрать агента Forge Guru для Rovo с нуля
  • Продолжи онбординг по Atlassian Forge с фазы setup

Как установить forge-onboarding

1Через Skills CLI (Vercel)

npx skills add atlassian/forge-skills --skill forge-onboarding -a claude-code

2Вручную: положить файлы

~/.claude/skills/forge-onboarding/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/forge-onboarding/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о forge-onboarding

Как установить forge-onboarding в Claude Code?

Запустите команду npx skills add atlassian/forge-skills --skill forge-onboarding -a claude-code в терминале.

Что делает forge-onboarding?

Пошагово сопровождает создание, сборку, деплой в среду development и установку агента Forge Guru для Atlassian Rovo.

Что нужно для работы forge-onboarding?

Требуются python3 (или локальный python) для запуска генератора, установленный Forge CLI, аккаунт Atlassian и тестовый сайт для установки приложения.

Исходный текст

SKILL.md · Apache-2.0
---
name: forge-onboarding
description: Guide a first-time Forge builder through building Forge Guru, a Rovo Agent that answers Forge questions. 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.
license: Apache-2.0
metadata:
  labels: "confluence,jira,atlassian,forge,onboarding,rovo,agent"
  maintainer: amoore
  namespace: cloud
---

# Forge onboarding

Guide a first-time builder from zero to a deployed, installed Rovo Agent — **Forge Guru** —
in one continuous run. One intro, one setup gate, one build. Keep the agent concise;
self-service readers get a strong welcome up front, workshop attendees get a slide-friendly flow.

## Load guidance by phase

Read only the reference for the current phase. Do not preload the entire journey, README,
assets, or evaluation cases. Use these stable phase names in state and transitions.

| Phase | Read when | Reference | Evidence to advance |
| --- | --- | --- | --- |
| `welcome` | Starting a new guided session | Use the welcome script below | User says they are ready to begin |
| `setup` | Beginning a new run (or a tool/login failure) | [Setup](references/setup.md) | Tools and login verified; dev space, test site, and app directory collected; bundled authorization granted |
| `build` | Running the end-to-end build | [Build](references/build.md) | Scaffold, customize, deploy, and install all succeeded on the authorized target |
| `celebrate` | Reporting success | [Celebrate](references/celebrate.md) | User knows where to find Guru and has example prompts to try |
| `next-steps` | Closing the tutorial | [Next steps](references/next-steps.md) | Iteration loop and sibling-skill routes shared |
| Recovery | An observed failure needs investigation | [Recovery](references/recovery.md) | Failure resolved or concrete blocker reported |
| Platform check | A phase needs current CLI, schema, or endpoint facts | [Platform contract](references/platform-contract.md) | Relevant fact verified and evidence recorded |

Default transition: `welcome → setup → build → celebrate → next-steps`.
Recovery returns to the interrupted phase. An exit stops the workflow immediately.

## Keep a compact session record

Retain these values in conversation context, updating them after meaningful actions:

| State | Record |
| --- | --- |
| Position | Phase, last completed action, next action |
| Local environment | OS/shell, Node and CLI versions, authentication result, accepted warnings |
| Local target | Absolute parent directory and app path; whether destination existed before creation |
| Atlassian target | Account, Developer Space name/ID, exact site, product, environment |
| Identity | Registered `app.id`, runtime, actual agent key/name, handler and action names |
| Progress | Scaffold created; Guru assets applied; dependencies installed; lint result; deploy and install confirmed |
| Live evidence | Guru answered a real Forge question; link to the agent on the site |
| Authorization | The single bundled authorization: exact approved actions, targets, and impacts |

Do not store credentials. Do not create a progress file unless the user requests one.

### Skip, exit, and resume

- Honor "skip the intro", "less explanation", and "exit".
- The `welcome` and `setup` gates are the only user-visible pauses in the default flow.
  Do not add further "ready?" prompts between read-only checks or between `build` steps.
- When resuming, reuse known results. Run only missing checks needed for the next command.
  A version warning is not a failed executable: explain it once and honor the user's choice.
- Collect targets at `setup`. The test site is required because `build` installs Guru.
  If the user has no site, follow the provision path in [Setup](references/setup.md).
- Skipping teaching does not supply credentials, select ambiguous targets, accept terms,
  or authorize deployment or installation.
- On exit, stop tools and questions. Briefly state what changed and what remains, using
  recorded evidence. Do not keep offering the next tutorial step.
- On resume, reuse context and inspect the app. Check identity and installation as relevant.
  Never rerun scaffolding over an existing app or replay completed edits, installs, consent,
  or lessons without a reason.

## Preserve execution boundaries

1. Narrate each step briefly as it runs. One line per command during `build`; batch
   explanations for independent checks. Report observed results, not anticipated success.
2. Keep secrets out of chat and files. Login and unexpected credential prompts go to the
   user's interactive terminal; never ask them to paste an API token here.
3. **One bundled authorization.** At the end of `setup`, disclose the full scope — scaffold
   at the exact directory, apply the Guru assets, deploy to `development`, install on the
   exact site — and get approval once. After approval, run all four actions in `build`
   without re-prompting. Local walkthroughs and read-only checks need no extra gate.
4. Terms and billing consent are separate from "build my app". The sibling creation helper
   currently passes `--accept-terms`. Disclose this as part of the bundled authorization;
   do not treat scaffold consent as independent of terms consent.
5. Register apps through `forge create` (via the sibling helper). Never invent an app ID
   or an unregistered replacement.
6. Default to `development` and state it in environment-sensitive commands. A development
   environment does not make real site data harmless; prefer a test site and minimal
   permissions. A different environment/site requires a separately scoped decision.
7. Preserve user files and app identity. Inspect the destination before scaffolding. Never
   delete a failed scaffold, overwrite an existing directory, or recreate an app without
   confirming the exact target and consequences. Preserve partial output for diagnosis.
8. Validate against current official guidance and `forge lint` before deploy. Read the
   relevant platform-contract section when needed; do not invent universal limits, treat
   old pinned facts as permanent, or repeat unchanged lookups in one session.
9. Do not perform unrequested source-control operations. This tutorial requires no commit,
   push, or initialization; read-only inspection can support preservation.
10. Deploy and install do not prove Guru works. Record the live Guru answer in `celebrate`
    as separate evidence from a successful install.

## Dependencies and attribution

The sibling `forge-app-builder` supplies `scripts.create_forge_app`. Before scaffolding,
run its `--help` smoke test and follow its creation reference as directed by the setup phase.
Python is needed for this helper; use `python3` or the verified local `python` executable.
Do not install dependencies merely to greet the user.

Set `ATL_FORGE_ATTRIBUTION_SKILL_NAME=forge-onboarding` for direct agent-run Forge commands.
Use an environment mapping when supported; otherwise use the user's shell syntax from
[Setup](references/setup.md#attribution). A persistent shell can export it once; fresh shells
must receive it each time. Exclude user-run login commands.
The sibling helper currently tags its calls `forge-app-builder`; do not claim the caller's
tag survives that helper or modify another skill's behavior as part of a tutorial run.

## Welcome script

Open a new guided session with this intro (roughly 150 words — concise, but strong enough
for a self-service reader with no slides). Adapt wording naturally; keep the beats in order.

> **Welcome to Forge onboarding.** Forge is Atlassian's platform for building apps that
> extend Jira, Confluence, Bitbucket, and more — no servers for you to manage. Forge has
> many module types for different kinds of extensions; today we're focused on the
> **Rovo Agent** module, which lets you build conversational agents that live inside
> Atlassian products.
>
> You're going to build **Forge Guru** — a Rovo Agent that lives on your developer site
> and answers any Forge question you throw at it. Think of it as your personal Forge
> guide while you build your first real Forge app.
>
> Here's the whole flow: I'll check your environment, collect your developer space and
> test site, then scaffold, customize, deploy, and install Guru end-to-end — about
> 10 minutes. After you approve the plan at setup, I'll run through the build without
> stopping. Everything happens on a test site; nothing touches real data or billing.
>
> **Ready to begin?**

Ask the readiness question only once, here. Do not repeat it later.

## Teach concisely

After the welcome, keep narration tight. One line before each command. Short status lines
during `build` ("Scaffolding…", "Deploying…"). No mid-flow concept lessons; if the user
asks "what is X" or "what did it just do", answer briefly and return to the flow.
End questions with a clear reply hint; do not add a question to every update.

## Completion and handoff

Default success is Forge Guru deployed and installed on the user's test site, answering a
real Forge question with a usable official link. Be explicit if a live check was skipped.
Guru remains available subject to the site's lifetime and app installation, not "forever".

Use `forge-app-builder` for subsequent feature work, `forge-debugger` for sustained diagnosis,
`forge-app-review` for release review, and `forge-connector` for connector work. Read
[Next steps](references/next-steps.md) when closing or discussing those routes.

© atlassian · Apache-2.0 · atlassian/forge-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
atlassian sanjay3290 Скилл atlassian для Claude Code управляет задачами Jira и страницами Confluence из агента. Ищет тикеты через JQL, читает документацию и меняет статусы. CX Codex +1 329установок atlassian-mcp https://github.com/Jeffallan Скилл atlassian-mcp для работы с Jira и Confluence через MCP-серверы: запросы на JQL и CQL, создание тикетов, спринты, поиск страниц. CX Codex +1 4 800установок atlassian-templates Alireza Rezvani Скилл atlassian-templates для Claude Code, который создаёт и правит шаблоны Jira и Confluence. Берёт на себя структуру страниц, макросы и стандартные блоки, чтобы контент в команде выглядел одинаково. CX Codex +1 680установок search-company-knowledge atlassian Скилл search-company-knowledge ищет информацию о процессах и системах одновременно в Confluence и Jira. Скилл пригодится, когда агенту нужно собрать факты из документации и тикетов со ссылками на источники. CX Codex +1 505установок atlassian-mcp-server reason-machines Скилл подключает агента к Jira, Confluence и Compass через удалённый MCP-сервер Atlassian. Он пригодится для поиска и изменения данных из IDE. CX Codex +1 186установок atlassian-admin borghei Скилл atlassian-admin для планирования и аудита администрирования Atlassian Cloud и Data Center: пользователи, права доступа, SSO, лицензии и здоровье инстанса. CX Codex +1 121установок

Из того же набора8

forge-app-builder Скилл forge-app-builder для Claude Code и Codex проектирует, создаёт и расширяет приложения Atlassian Forge для Jira и Confluence. Включается при работе с манифестом, интерфейсом UI Kit, Custom UI или бэкенд-логикой. CX Codex +1 552установок forge-app-review Скилл forge-app-review для Claude Code проводит аудит приложений Atlassian Forge перед релизом. Запускается по запросам на ревью манифеста, проверку готовности к деплою или общее качество кода. CX Codex +1 542установок forge-debugger Скилл forge-debugger для Claude Code, который ищет и исправляет ошибки в приложениях Atlassian Forge. Запускается при сбоях деплоя, пустом интерфейсе, ошибках резолвера и проблемах с правами. CX Codex +1 533установок forge-connector Скилл forge-connector для Claude Code, создающий приложения коннекторов Atlassian Forge Teamwork Graph для передачи внешних данных в поиск Rovo. CX Codex +1 453установок forge-security-review Скилл forge-security-review для Claude Code проверяет безопасность приложений Atlassian Forge по коду и Forge-правилам. Запускается по запросу аудита, проверки авторизации или анализа изоляции арендаторов. CX Codex +1 442установок forge-cost-optimizer Скилл forge-cost-optimizer для Claude Code анализирует расходы приложений Atlassian Forge. Находит лишние вызовы функций, запросы к API, записи в хранилище и частые триггеры. CX Codex +1 418установок forge-skills С набором скиллов и MCP-конфигурацией под Atlassian Forge. Скаффолдит приложения, проверяет их перед деплоем, чинит прод и держит агента в курсе API Forge. ★ 33звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой