[DOCS] `/install-github-app` docs omit optional GitHub App-only setup path
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/github-actions
https://code.claude.com/docs/en/commands
Section/Topic
Setup -> Quick setup and Manual setup for /install-github-app.
Current Documentation
The current quick setup text says:
The easiest way to set up this action is through Claude Code in the terminal. Just open claude and run /install-github-app. This command will guide you through setting up the GitHub app and required secrets.
Local evidence: docs/code.claude.com/docs/en/github-actions.md:37-39
The note still presents secrets as part of the required setup path:
You must be a repository admin to install the GitHub app and add secrets
Local evidence: docs/code.claude.com/docs/en/github-actions.md:41-43
The commands reference describes /install-github-app only as GitHub Actions setup:
/install-github-app | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration
Local evidence: docs/code.claude.com/docs/en/commands.md:87
What's Wrong or Missing?
Claude Code v2.1.187 changed /install-github-app so GitHub Actions workflow setup is optional. Users can install just the GitHub App and skip the workflow and secret steps.
The current docs still imply that /install-github-app always guides users through GitHub App setup plus required secrets, and the manual setup path still presents ANTHROPIC_API_KEY and .github/workflows/ setup as mandatory follow-on steps. That omits the new App-only path.
Suggested Improvement
Update the GitHub Actions quick setup section to distinguish the two setup choices. For example:
Run /install-github-app from Claude Code to install the Claude GitHub App for a repository. During setup, you can choose whether to also configure the GitHub Actions workflow. If you only need the GitHub App, you can skip the workflow and repository-secret steps.
Then update the note and manual setup steps so ANTHROPIC_API_KEY and workflow-file creation are described as required only when configuring GitHub Actions workflows, not when installing only the GitHub App. Also update the /install-github-app row in the commands reference to mention that workflow setup is optional.
Impact
Medium - Makes feature difficult to understand
Additional Context
Release context: Claude Code v2.1.187 release note says: Improved /install-github-app: GitHub Actions workflow setup is now optional — you can install just the GitHub App and skip the workflow/secret steps.
Duplicate check found no open issue titles matching install-github-app, workflow setup, secret steps, or optional workflow.