Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add paleo/alignfirst --skill alignfirst-setup-guidegit clone --depth 1 https://github.com/paleo/alignfirstWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/paleo/alignfirst/alignfirst-setup-guide)<a href="https://agentmods.dev/skills/paleo/alignfirst/alignfirst-setup-guide"><img src="https://agentmods.dev/badge/skills/paleo/alignfirst/alignfirst-setup-guide/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/paleo/alignfirst/alignfirst-setup-guide"><img src="https://agentmods.dev/badge/skills/paleo/alignfirst/alignfirst-setup-guide.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 1 finding, up to medium
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- medium MCP Rug Pull · line 121 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00080 | $0.02329 |
| Opus 5.5 | $0.00032 | $0.00932 |
| Sonnet 5.5 | $0.00016 | $0.00466 |
| Haiku 4.5 | $0.00008 | $0.00233 |
Grade A, and why
alignfirst-setup-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 151 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AlignFirst Setup Guide
Route by the user's intent. Load only the references needed for that route. Docmap, workspace, and the AlignFirst skills can each be adopted independently.
Terminology
The AlignFirst CLI is the alignfirst npm package and bin. It provides guide, ticket, sync,
plans, docmap, conventions, context, config, and doctor.
The AlignFirst skills are stubs that run the CLI. The nine command skills alspec, alplan,
al, almerge, alreview, aldescription, alcatchup, alcatchupaad, and alcatchupspec keep
disable-model-invocation: true; humans invoke them as /alspec in Claude Code, GitHub Copilot,
Cursor, or $alspec in Codex. The optional alignfirst skill lets the agent recognize a protocol
named in prose; a project whose instruction file starts with the canonical alignfirst context
section provides this itself.
A work-files repository is an optional CLI mode configured through alignfirst plans setup.
aligndev, the AlignDev CLI, carries the assistant's playbook, coding-agent delegation, and project
discovery. An OpenClaw assistant host installs it; a coding-agent assistant runs it through npx.
An Untouched Repository
When the user wants nothing written in the repository, every route below goes through companion-setup.md. The project's AlignFirst files then live in its companion directory, and only the tools that mode supports apply.
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 CLI, protocols, or skills: alignfirst-skills-setup.md. Install only the requested components; skills invoke the CLI through
npxwithout a separate installation. For an existing v1, v2, or v3 installation, a machine with~/.config/alignfirst/, or a companion registry withpaths, start with alignfirst-upgrade.md. - Work-files repository: plans-setup.md.
- docmap: docmap-setup.md. An instruction file with the old docmap body ("Mandatory for every task") needs Update the Docmap Snippet.
- workspace: workspace-setup.md. A
portsgroup orsetupProfilesinworkspace.mjsneeds Move Workspace Ports to the Dev-Server. - AlignDev (
aligndev): ask the user whether it serves an OpenClaw assistant or a coding agent (Claude Code or Codex). For OpenClaw, follow AlignDev for OpenClaw. For a coding agent, follow coding-agent-assistant.md, which installs thealigndevskill globally. An old~/.alignfirst/aligndev.config.jsonneeds Rename the AlignDev Settings.
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- assets/aligndev-openclaw-template/base/.alignfirst.json 327 B
- assets/aligndev-openclaw-template/base/.gitignore 98 B
- assets/aligndev-openclaw-template/base/AGENTS.md 2.0 KB
- assets/aligndev-openclaw-template/base/DEVELOPERS.md 1.7 KB
- assets/aligndev-openclaw-template/base/docs/configuration.md 2.9 KB
- assets/aligndev-openclaw-template/base/docs/gotchas.md 12 KB
- assets/aligndev-openclaw-template/base/docs/installations/01-server-setup.md 7.5 KB
- assets/aligndev-openclaw-template/base/docs/installations/02-admin-repository.md 2.9 KB
- assets/aligndev-openclaw-template/base/docs/installations/03-toolchain.md 7.6 KB
- assets/aligndev-openclaw-template/base/docs/installations/04-openclaw.md 17 KB
- assets/aligndev-openclaw-template/base/docs/installations/05-openclaw-dependencies.md 8.0 KB
- assets/aligndev-openclaw-template/base/docs/installations/06-security-hardening.md 12 KB
- assets/aligndev-openclaw-template/base/docs/operations/add-project.md 3.5 KB
- assets/aligndev-openclaw-template/base/docs/operations/configure-assistant.md 2.7 KB
- assets/aligndev-openclaw-template/base/docs/operations/recover-assistant.md 4.0 KB
- assets/aligndev-openclaw-template/base/docs/operations/update-assistant.md 16 KB
- assets/aligndev-openclaw-template/base/docs/operations/update-workspace.md 2.3 KB
- assets/aligndev-openclaw-template/base/docs/overview.md 3.8 KB
- assets/aligndev-openclaw-template/base/docs/troubleshooting.md 2.9 KB
- assets/aligndev-openclaw-template/base/infra/openclaw/.env.example 1.5 KB
- assets/aligndev-openclaw-template/base/infra/openclaw/.gitignore 5 B
- assets/aligndev-openclaw-template/base/infra/openclaw/apparmor/playwright-chromium 527 B
- assets/aligndev-openclaw-template/base/infra/openclaw/bin/apply-heartbeat-scratch.sh 2.6 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/bin/apply-workspace.sh 2.2 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/bin/assistant-kill.sh 4.3 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/bin/assistant-maintenance.sh 8.3 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/bin/backup.sh 3.3 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/bin/openclaw 339 B
- assets/aligndev-openclaw-template/base/infra/openclaw/environment.d/common.conf 557 B
- assets/aligndev-openclaw-template/base/infra/openclaw/heartbeat-scratch.md 180 B
- assets/aligndev-openclaw-template/base/infra/openclaw/node-runtime/admin-npm 191 B
- assets/aligndev-openclaw-template/base/infra/openclaw/node-runtime/check-project-runtimes.sh 8.4 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/node-runtime/gateway-path.conf 255 B
- assets/aligndev-openclaw-template/base/infra/openclaw/node-runtime/init.bash 1.1 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/node-runtime/project-shell 399 B
- assets/aligndev-openclaw-template/base/infra/openclaw/projects/.alignfirst-projects.json 241 B
- assets/aligndev-openclaw-template/base/infra/openclaw/seed.sh 6.9 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/seed/common.sh 8.9 KB runs code
- assets/aligndev-openclaw-template/base/infra/openclaw/workspace/IDENTITY.md 460 B
- assets/aligndev-openclaw-template/base/infra/openclaw/workspace/SOUL.md 395 B
- assets/aligndev-openclaw-template/base/infra/openclaw/workspace/USER.md 367 B
- assets/aligndev-openclaw-template/base/package.json 404 B
- assets/aligndev-openclaw-template/base/README.md 1.7 KB
- assets/aligndev-openclaw-template/base/scripts/workspace/workspace.mjs 1.1 KB runs code
- assets/aligndev-openclaw-template/variants/coding-agents/claude-code/CLAUDE.md 11 B
- assets/aligndev-openclaw-template/variants/coding-agents/claude-code/docs/installations/08-coding-agent.md 8.9 KB
- assets/aligndev-openclaw-template/variants/coding-agents/claude-code/infra/openclaw/aligndev.settings.json 165 B
- assets/aligndev-openclaw-template/variants/coding-agents/claude-code/infra/openclaw/coding-agent/CLAUDE.md 2.3 KB
- assets/aligndev-openclaw-template/variants/coding-agents/claude-code/infra/openclaw/seed/coding-agent.sh 628 B runs code
- assets/aligndev-openclaw-template/variants/coding-agents/codex/docs/installations/08-coding-agent.md 11 KB
- assets/aligndev-openclaw-template/variants/coding-agents/codex/infra/openclaw/aligndev.settings.json 282 B
- assets/aligndev-openclaw-template/variants/coding-agents/codex/infra/openclaw/coding-agent/AGENTS.md 2.3 KB
- assets/aligndev-openclaw-template/variants/coding-agents/codex/infra/openclaw/seed/coding-agent.sh 658 B runs code
- assets/aligndev-openclaw-template/variants/options/dev-server-gateway/docs/installations/09-dev-server-gateway.md 7.5 KB
- assets/aligndev-openclaw-template/variants/options/dev-server-gateway/infra/gateway/authelia.yml 979 B
- assets/aligndev-openclaw-template/variants/options/dev-server-gateway/infra/gateway/Caddyfile 556 B
- assets/aligndev-openclaw-template/variants/surfaces/discord/docs/installations/07-channel.md 4.6 KB
- assets/aligndev-openclaw-template/variants/surfaces/discord/docs/operations/pair-dm-sender.md 711 B
- assets/aligndev-openclaw-template/variants/surfaces/discord/infra/openclaw/.env.example 2.3 KB
- assets/aligndev-openclaw-template/variants/surfaces/discord/infra/openclaw/seed/surface.sh 2.9 KB runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today Changed f51452cc51df
- 2d ago Changed 692e6aa17ba0
- 3d ago Changed · -10 lines 0f6bdd440875
- 6d ago Changed · -2 lines · +13 tokens per session c53264757a7f
- 7d ago Changed e34c69a0d6c6
- 8d ago Changed 812c541e3d9a
- 9d ago Changed · +6 lines · +11 tokens per session 4b8a7ddaa729
- 13d ago Changed · +7 lines · +11 tokens per session b06f0c409597
- 21d ago Changed 74b9b06c7675
- 24d ago First seen · 150 lines · 45 tokens per session scan A 227db92a0526
alignfirst-setup-guide is a skill published in the GitHub repository paleo/alignfirst (85 stars, last pushed today), licensed CC0-1.0. It adds 80 tokens to every session and 2,329 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
plan
Write a short implementation plan or a longer execution plan before coding. Use when starting new work, when a ticket needs clearer boundaries, when a change spans multiple files or interfaces, or when a multi-hour task needs a living plan.
ai-news-research
You produce a daily AI news digest. Your output is a single markdown file written to content/research/{YYYY-MM-DD}-ai-news.md and committed to a branch.
linkedin-post
You take a YouTube video transcript and produce a single LinkedIn post draft.
youtube-description
You take a YouTube video transcript and produce the video description (with timestamps) and chapter list.
code-review
Review code changes for bugs, security issues, performance problems, and style violations. Use when asked to review code, a PR, or recent changes.
google-tag-manager
Skill "google-tag-manager" from VKirill/claude-lane-stack, covering 🎯 version requirements (june 2026), usage, use this skill when, do not use this skill when and purpose.