New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Tophat Build Install

by nimblehq in nimblehq/ios-templates

Find, build, and install mobile artifacts for the current repository through GitHub Actions and Tophat.

MITAuto-check passedDevOps & Cloud

Install Tophat Build Install

skills CLI
$ npx skills add nimblehq/ios-templates --skill tophat-build-install -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nimblehq/ios-templates tophat-build-install --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nimblehq/ios-templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tophat-build-install .claude/skills/tophat-build-install && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tophat-build-install
GitHub stars
110
Token cost
~1k tokens
SKILL.md length
552 words
Files
6 (incl. scripts, references)
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Find, build, and install mobile artifacts for the current repository through GitHub Actions and Tophat.

  • Works in 5 steps: Infer the current repository. → Resolve the target from the user request. → If the user gave an explicit artifact… → …
  • Requests like install the latest build from main
  • SKILL.md covers Inputs, Default Flow, Build Resolution and Install, plus 1 more section
  • Runs Python scripts from its folder

What it does

Tophat Build Install is an agent skill from nimblehq/ios-templates. Find, build, and install mobile artifacts for the current repository through GitHub Actions and Tophat. Use it for requests like "install the latest build from main", "install PR

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/public-contract.md`, `scripts/gha.py` and `scripts/install_artifact.py`).

It sits in DevOps & Cloud, covering CI/CD. It works with GitHub Actions and iOS. The repository describes itself as: Our optimized iOS templates used in our projects. The licence is MIT.

When your agent uses it

  • Requests like install the latest build from main
  • Tasks that involve CI/CD

Example prompts

  • “install the latest build from main”
  • “/tophat-build-install”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Infer the current repository.
  2. Resolve the target from the user request.
  3. If the user gave an explicit artifact ID, install it directly.
  4. Otherwise, look for an existing artifact first.
  5. Trigger a workflow only when no suitable artifact exists or the user explicitly asked for a rebuild.

What it can do on your machine

Read from SKILL.md and the folder at commit f009d02. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tophat Build Install loads about 1k tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 552 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from nimblehq/ios-templates at commit f009d02, republished under its MIT licence (© nimblehq). 552 words, ~1,037 tokens.

Download SKILL.mdSave it as .claude/skills/tophat-build-install/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
tophat-build-install
description
Find, build, and install mobile artifacts for the current repository through GitHub Actions and Tophat. Use it for requests like "install the latest build from main", "install PR

Tophat Build Install

Use this skill to turn a user request into a concrete GitHub Actions artifact install through Tophat.

This skill is GitHub Actions only. Require:

  • gh
  • Tophat at /Applications/Tophat.app/Contents/MacOS/tophatctl with the gha provider installed
  • a repository that already publishes GitHub Actions artifacts

Do not switch to another artifact provider from this skill.

Inputs

Collect only the missing inputs.

  • Platform: ios or android.
  • Repository: derive it from the current checkout first. Ask only if there is no usable GitHub remote.
  • Source selector: branch, PR number, workflow run ID, or explicit artifact ID.
  • Workflow: only when a new build must be triggered.
  • Destination: simulator or device when it matters.
  • Launch arguments: only if the app needs them.

If the user says "latest build", prefer the latest successful existing run for the requested branch instead of forcing a rebuild. If the user says "build", "rebuild", or "trigger", dispatch a new workflow run first.

Default Flow

Use this order:

  1. Infer the current repository.
  2. Resolve the target from the user request.
  3. If the user gave an explicit artifact ID, install it directly.
  4. Otherwise, look for an existing artifact first.
  5. Trigger a workflow only when no suitable artifact exists or the user explicitly asked for a rebuild.

Build Resolution

Resolve the user's target into a concrete artifact. Use gh when you need to inspect PRs, workflows, runs, or artifacts. Use scripts/gha.py list-artifacts when you want the local helper to list non-expired artifacts for the current repo or a chosen selector.

The helper prefers the repository-wide artifacts endpoint, but if GitHub returns 404 there it should fall back to recent workflow runs instead of stopping immediately.

Prefer this order:

  1. If the user gave an explicit artifact ID, install it directly.
  2. If the user gave a workflow run ID, list artifacts and match artifact.workflow_run.id.
  3. If the user gave a PR number, resolve the PR head branch and head SHA, then list artifacts for that head.
  4. If the user gave a branch or commit SHA, list artifacts and match branch and-or SHA.
  5. Trigger a workflow only when no matching non-expired artifact exists or the user explicitly asked for a rebuild.

scripts/gha.py list-artifacts supports these selectors:

  • --ref <branch>
  • --sha <commit-or-prefix>
  • --pr <number>
  • --run-id <database-id>

If multiple artifacts exist, ask the user which artifact to install. Do not filter artifact selection by platform because GitHub Actions artifact names may not include platform text. Use platform only as a Tophat recipe hint during install.

Show full SKILL.md (138 more words)Show less

Install

Prefer scripts/install_artifact.py for the normal install flow. It creates a temporary recipe, calls Tophat, prints a short status line, and removes the recipe unless --keep-recipe is set.

Use /Applications/Tophat.app/Contents/MacOS/tophatctl as the Tophat CLI path. Keep that path explicit when reporting missing local tooling so agents do not guess.

Use scripts/make_recipe.py directly only when you need the raw recipe JSON.

For gha, the recipe must include:

  • owner
  • repo
  • artifact_id

If owner and repo are omitted, infer them from Git.

Treat the known tophatctl timeout as "install may still be in progress in Tophat", not as a hard failure.

For destination=device, use only workflows that already produce signed device builds. If that path does not exist, stop and explain it.

Reference Notes

Read references/public-contract.md when you need the public Tophat schema, the GitHub Actions provider details, or command examples.

© nimblehq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/tophat-build-install of nimblehq/ios-templates.

  • SKILL.md
  • references/public-contract.md
  • scripts/gha.py
  • scripts/install_artifact.py
  • scripts/install_with_tophat.py
  • scripts/make_recipe.py

Open the folder on GitHubat commit f009d02

Compare with similar skills

Tophat Build Install next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tophat Build Install compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tophat Build Install this skillnimblehq/ios-templates110—~1kAutomated safety check: PassMIT
GitHub Actionscallstackincubator/agent-skills1.7k1 repos~703Automated safety check: PassMIT
Makepad Deploymentsickn33/agentic-awesome-skills47k2 repos~3kAutomated safety check: NotesMIT
CI CD Setuprshankras/claude-code-apple-skills787—~1.5kAutomated safety check: NotesMIT
Godot Export Buildsthedivergentai/GD-Agentic-Skills821—~3kAutomated safety check: PassLGPL-3.0
Lokalise Deploy Integrationjeremylongshore/tons-of-skills-marketplace2.8k—~3.4kAutomated safety check: PassMIT

Similar skills

  • GitHub Actions

    callstackincubator/agent-skills

    Official

    GitHub Actions workflow patterns for React Native iOS simulator and Android emulator cloud builds with downloadable artifacts.

    1.7k GitHub starsUsed in 1 repo~703 tokens
    DevOps & CloudAuto-check passed

  • Makepad Deployment

    sickn33/agentic-awesome-skills

    CRITICAL: Use for Makepad packaging and deployment. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~3k tokens
    DevOps & CloudAuto-check: notes

  • CI CD Setup

    rshankras/claude-code-apple-skills

    Generate CI/CD configuration for automated builds, tests, and distribution of iOS/macOS apps.

    787 GitHub stars~1.5k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check: notes

  • Godot Export Builds

    thedivergentai/GD-Agentic-Skills

    Expert patterns for multi-platform exports including export templates (Windows/Linux/macOS/Android/iOS/Web), command-line exports (headless mode), platform-specific settings (codesign, notarization…

    821 GitHub stars~3k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

  • Lokalise Deploy Integration

    jeremylongshore/tons-of-skills-marketplace

    Deploy Lokalise integrations to Vercel, Netlify, and Cloud Run platforms.

    2.8k GitHub stars~3.4k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

  • Submit Aetherkiri Cross Repo PRs

    AetherKiri/Aether

    Prepare, validate, push, open, monitor, and merge paired pull requests across the public AetherKiri repository and private AetherInternal package without publishing private source or unrelated…

    154 GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from nimblehq/ios-templates

  • Swift Concurrency

    nimblehq/ios-templates

    Write, review, or fix Swift 6 concurrency code using actors, Sendable, structured concurrency, and the strict data-race-safety model.

    110 GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed

  • Swift Testing

    nimblehq/ios-templates

    Write, review, or migrate unit tests using Swift Testing (@Test, @Suite, expect, require).

    110 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed

  • Commit

    nimblehq/ios-templates

    Generate and create a git commit following Nimble's Compass convention ([ID] Verb message).

    110 GitHub stars~790 tokensUpdated 2 mo ago
    Auto-check passed

  • Resolve PR Comments

    nimblehq/ios-templates

    Guided workflow to address, reply to, and resolve GitHub PR review threads — one at a time, collaboratively.

    110 GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Tophat Build Install

What does Tophat Build Install do?

Find, build, and install mobile artifacts for the current repository through GitHub Actions and Tophat. Tophat Build Install is an agent skill from nimblehq/ios-templates. Find, build, and install mobile artifacts for the current repository through GitHub Actions and Tophat.

When should I use Tophat Build Install?

Tophat Build Install fits situations like: requests like install the latest build from main; tasks that involve CI/CD.

How do I install Tophat Build Install in Claude Code?

Run `npx skills add nimblehq/ios-templates --skill tophat-build-install -a claude-code`. Or copy the skill folder (skills/tophat-build-install in nimblehq/ios-templates) into .claude/skills/tophat-build-install in your project. Claude Code loads it when a task matches its description.

How do I install Tophat Build Install in Codex?

Run `npx skills add nimblehq/ios-templates --skill tophat-build-install -a codex`. Or copy the skill folder (skills/tophat-build-install in nimblehq/ios-templates) into .agents/skills/tophat-build-install in your project. Codex loads it when a task matches its description.

Can I use Tophat Build Install in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nimblehq/ios-templates --skill tophat-build-install -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tophat-build-install, .gemini/skills/tophat-build-install, .github/skills/tophat-build-install and .opencode/skills/tophat-build-install in your project.

What does Tophat Build Install need to run?

Going by SKILL.md and its folder, Tophat Build Install needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Tophat Build Install access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tophat Build Install safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tophat Build Install use?

Tophat Build Install is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tophat Build Install use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 478 tokens, read only when the agent opens those files.

What are the alternatives to Tophat Build Install?

Skills that share tags, products or a category with Tophat Build Install: GitHub Actions (callstackincubator/agent-skills, 1.7k stars), Makepad Deployment (sickn33/agentic-awesome-skills, 47k stars), CI CD Setup (rshankras/claude-code-apple-skills, 787 stars) and Godot Export Builds (thedivergentai/GD-Agentic-Skills, 821 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tophat Build Install?

nimblehq (a GitHub organization) maintains it in nimblehq/ios-templates, which has 110 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on July 27, 2026.

Source: nimblehq/ios-templates on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.