SkillsAdd

paleo/alignfirst

alignfirst-setup-guide

>- Install, upgrade, recommend, or combine AlignFirst skills, plans-share, docmap, and workspace in a consumer repository, or prepare a repository and Linux deployment for an AlignFirst Developer.

Hot #2463 First seen Jun 27, 2026

Installation

$ npx skills add paleo/alignfirst --skill alignfirst-setup-guide
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic
anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from paleo/alignfirst · top by installs.

npx skills add paleo/alignfirst
alignfirst 8 alspec 8 alplan 8 aldescription 8 al 8 alreview 8 alread 146 almerge 8 alignfirst-coaching 90 openclaw-coder-playbook 87

Browse all from paleo/alignfirst

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Declared
Codex Declared
GitHub Copilot Declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 86
License LICENSE
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.32.0
LicenseCC0 1.0
CompatibilityRequires git and a Node.js package manager (npm, pnpm, yarn, or bun).
Declared agents claude-code cursor codex github-copilot
More metadata
author
Paleo
version
0.32.0
repository
https://github.com/paleo/alignfirst

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 6,059 B
  • docs SUMMARY.md 223 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 78 installs

SKILL.md

AlignFirst Setup Guide

Route by the user's intent. Load only the references needed for that route.

Terminology

AlignFirst is both the core alignfirst skill and the umbrella name for the related software development tooling in this repository. In skill contexts, AlignFirst means the core skill, used alone or with its command-alias companions. The core skill and any installed companions are the AlignFirst skills. Use AlignFirst tooling for the broader product family when the distinction matters.

The alignfirst skill contains the protocols. Its seven human-invoked command companions are alspec, alplan, al, almerge, alreview, aldescription, and alcatchup. The command skills keep disable-model-invocation: true, humans invoke them as /alspec in Claude Code, GitHub Copilot, Cursor, or $alspec in Codex.

alignfirst-setup-guide and alignfirst-developer-openclaw-playbook are separate skills. plans-share is an optional companion to AlignFirst skills, not a fourth independent recommendation.

Named Tool

When the user names a tool, inspect the repository and proceed directly to that tool. Install or upgrade only what they requested.

  • AlignFirst skills: [alignfirst-skills-setup.md](references/alignfirst-skills-setup.md). For an

existing v1 or v2 installation, start with [alignfirst-upgrade.md](references/alignfirst-upgrade.md).

  • plans-share: [plans-share-setup.md](references/plans-share-setup.md).
  • docmap: [docmap-setup.md](references/docmap-setup.md).
  • workspace: [workspace-setup.md](references/workspace-setup.md).

Do not present the tooling menu or add unrelated tools on this route.

Tooling Recommendation

When the user asks what the project could adopt, inspect the repository and present these independent choices:

  • AlignFirst skills add collaborative specification, planning, implementation, merge, review,

description, and catch-up commands. When the team has a plans repository, plans-share can back the project's .plans directory.

  • docmap makes the repository's docs/ tree discoverable to agents and humans.
  • workspace creates isolated git-worktree development environments.

Determine whether a team plans repository exists before recommending plans-share. Let the user choose any subset.

AlignFirst Developer

An AlignFirst Developer is a persistent AI teammate for software work. It receives requests through team chat, manages each task in an isolated project workspace, and delegates repository work to a coding agent (Claude Code or Codex) using the AlignFirst protocols. The current deployment runs on OpenClaw through Slack or Discord under a dedicated Linux service account.

Preparing a project makes its repository compatible with an AlignFirst Developer. Creating an AlignFirst Developer builds and deploys the teammate itself.

Prepare a Project for an AlignFirst Developer

Inspect the repository before changing it. A prepared project has all of these:

  1. AlignFirst skills and their project-specific AGENTS.md or CLAUDE.md section.
  2. plans-share when a team plans repository exists.
  3. docmap, including project scripts and agent instructions. When the repository has no docs/

directory, bootstrap its documentation through [docmap-bootstrapping.md](references/docmap-bootstrapping.md) as part of the preparation.

  1. workspace, adapted to the project's runtime and development lifecycle, meeting

[the AlignFirst Developer contract](references/workspace-setup.md#the-alignfirst-developer-contract).

  1. A project-specific DEVELOPERS.md for an unfamiliar developer: commands, architecture,

documentation map, development workflow, and verification procedures.

Detect and verify the package manager, runtime, build, test, lint, dev-server, ports, shared directories, seeded configuration files, and team-plan details. Write only facts confirmed from the repository. Follow each selected tool reference above, then complete DEVELOPERS.md.

Create an AlignFirst Developer

For creating or operating the developer deployment itself, read [alignfirst-developer.md](references/alignfirst-developer.md). Do not load that workflow for ordinary tool setup.

Shared Investigation Rules

Detect the package manager from packageManager in package.json, then the root lockfile: package-lock.json means npm, pnpm-lock.yaml means pnpm, yarn.lock means yarn, and bun.lock or bun.lockb means bun. Fall back to npm.

Translate commands to that package manager. npm needs -- before script flags; pnpm and yarn omit run and the separator; bun keeps run but omits the separator.

Detect existing footprints before proposing changes:

  • docmap: a docmap script, @paleo/docmap, or docs/.
  • workspace: a workspace script or @paleo/workspace.
  • AlignFirst skills: a canonical skill installation, .plans/, or an AlignFirst instruction section.
  • plans-share: a plans-share script, dependency, or .plans symlink.
  • AlignFirst Developer preparation: the complete five-part contract above.

Require a clean working tree immediately before project mutations. Read-only discovery and recommendations do not require one.

Temporary Local Installation

When this guide was installed only for the current project, remove it through the skills CLI after setup:

npx -y skills remove alignfirst-setup-guide --yes </dev/null

The CLI owns skills-lock.json. Leave global installations in place for other repositories. An AlignFirst Developer service account must retain a global installation for its delegated coding agent.