Skip to content
Diagnosis · Code

alignfirst-setup-guide

Setup-time companion to install or upgrade any subset of {docmap, workspace, alignfirst skills} in a consumer repo.

Examining code for the line that is wrong

Works with
ClaudeChatGPTGeminiClaude CodeCodexCursorCopilotGemini CLI
Setup
One command
Best in a coding tool, where its scripts can run.
Contains
Instructions + 16 scripts
Shell and JavaScript.
Maintained
Last change 4 Oct 2026
On the repository’s main branch.

What it does

A one-time companion for setting up a consumer repository. It installs any subset of three independent tools:

When your AI uses it

Use when asked to install, set up, or upgrade docmap, the workspace worktree system, or the AlignFirst skills

You don’t need to name it. Ask for the job in your own words — your AI loads the skill when the request matches.

What it can touch

  • Includes 16 scripts

    Your AI can run these when the skill is used — on your computer in a coding tool (which asks first unless you have told it not to), or in the AI’s own sandbox in Claude and ChatGPT.

    How we know

    Found in the skill’s folder: assets/alignfirst-dev-kit-template/base/infra/openclaw/bin/apply-heartbeat-scratch.sh, assets/alignfirst-dev-kit-template/base/infra/openclaw/bin/apply-workspace.sh, assets/alignfirst-dev-kit-template/base/infra/openclaw/bin/assistant-kill.sh, assets/alignfirst-dev-kit-template/base/infra/openclaw/bin/assistant-maintenance.sh….

  • Installs other software

    Following it will install packages (npm, pip, brew or similar). Those come from their own publishers, not from this skill.

    How we know

    The SKILL.md contains package-install commands.

  • Asks for administrator rights

    Some of its commands use sudo or "run as administrator". Those can change anything on your computer.

    How we know

    Seen in its code. Read 2026-10-05, commit 665d2cb.

  • 12 smaller things worth knowing

    Gives itself administrator powers permanently; Runs a well-known installer straight from the web; Contains commands that delete or overwrite; Refers to a credentials file (SSH keys, cloud logins, tokens); and more. Usually legitimate — listed so nothing is hidden.

    How we know

    Gives itself administrator powers permanently — assets/alignfirst-dev-kit-template/base/docs/installations/01-server-setup.md line 26; Runs a well-known installer straight from the web — assets/alignfirst-dev-kit-template/base/docs/installations/01-server-setup.md line 143; Contains commands that delete or overwrite — assets/alignfirst-dev-kit-template/base/docs/installations/03-toolchain.md line 35; Refers to a credentials file (SSH keys, cloud logins, tokens) — assets/alignfirst-dev-kit-template/base/docs/installations/03-toolchain.md line 136; Sets itself up to run again automatically later — assets/alignfirst-dev-kit-template/base/docs/installations/04-openclaw.md line 152; Sets itself up to run again automatically later — assets/alignfirst-dev-kit-template/base/docs/installations/06-security-hardening.md line 109. Read 2026-10-05, commit 665d2cb.

    assets/alignfirst-dev-kit-template/base/docs/installations/01-server-setup.md, line 26 ↗assets/alignfirst-dev-kit-template/base/docs/installations/01-server-setup.md, line 143 ↗assets/alignfirst-dev-kit-template/base/docs/installations/03-toolchain.md, line 35 ↗assets/alignfirst-dev-kit-template/base/docs/installations/03-toolchain.md, line 136 ↗assets/alignfirst-dev-kit-template/base/docs/installations/04-openclaw.md, line 152 ↗assets/alignfirst-dev-kit-template/base/docs/installations/06-security-hardening.md, line 109 ↗
  • No serious risk pattern found

    Launch7’s automated check read all 82 text files in this skill and matched none of its serious risk patterns. This is not a guarantee: a check like this can miss new or disguised tricks, and the author can change the files after the check.

    How we know

    Read 2026-10-05, commit 665d2cb by pipeline/trust/analyze.py — 40+ patterns for hidden text, prompt injection, downloads that run, credential access and more. It reads; it never runs the skill.

  • Recently maintained

    Its repository has had changes recently.

    How we know

    Last push to paleo/alignfirst: 2026-10-04 (1 days before the scan).

Read automatically from the skill’s own files on GitHub on 5 Oct 2026. Launch7 does not run or manually review skills: this lists what the check saw, and nothing here means “safe”. How we check

Add it to your AI

Partly. Upload it in Claude’s settings — the instructions work; the scripts need the full folder.

  1. Built in your browser from the SKILL.md on GitHub — nothing passes through Launch7.

  2. In Claude, open Customize → Skills, press +, then Create skill → Upload a skill, and choose the .zip.

  3. Make sure code execution is switched on (Settings → Capabilities). Skills need it.

  4. Start a new chat and ask for the job in your own words — Claude picks the skill up when it fits.

This skill ships 16 scripts beside its instructions. The download here is the SKILL.md alone — enough for the instructions, not for the parts that run code. Use the command route, or take the full folder from the repository.

How Claude does this: support.claude.com · checked 28 Sep 2026 · “Supported” means documented by the vendor; Launch7 has not run it end to end

  • alignfirst

    Collaborative problem-solving protocols.

    paleoInstalls other software