Agent skill

Align

by lexler in lexler/skill-factory

Presents a proposed approach in progressive confirmable chunks with recommended decisions and alternatives.

Apache-2.0Auto-check passed

Install Align

skills CLI
$ npx skills add lexler/skill-factory --skill align -a claude-code

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

GitHub CLI
$ gh skill install lexler/skill-factory align --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/lexler/skill-factory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/output_skills/design/align .claude/skills/align && 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
align
GitHub stars
239
Token cost
~900 tokens
SKILL.md length
472 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
Apache-2.0

At a glance

Presents a proposed approach in progressive confirmable chunks with recommended decisions and alternatives.

  • Works in 4 steps: Goal → Big Picture → Straightforward Details → …
  • Aligning on a design
  • SKILL.md covers Goal, Core Principle, Flow — Zoom In and After Corrections, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Align is an agent skill from lexler/skill-factory. Presents a proposed approach in progressive confirmable chunks with recommended decisions and alternatives. Use when aligning on a design, plan, or technical approach before implementation.

Its SKILL.md is about 900 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is Apache-2.0.

When your agent uses it

  • Aligning on a design
  • Technical approach before implementation

Example prompts

  • “Use the align skill to present a proposed approach in progressive confirmable chunks with recommended decisions and alternatives”
  • “/align”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Goal
  2. Big Picture
  3. Straightforward Details
  4. Non-obvious Decisions

What it can do on your machine

Read from SKILL.md and the folder at commit 8017333. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Align loads about 900 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 472 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~900

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from lexler/skill-factory at commit 8017333, republished under its Apache-2.0 licence (© lexler). 472 words, ~900 tokens.

Download SKILL.mdSave it as .claude/skills/align/SKILL.md (or your agent's skills folder).
name
align
description
Presents a proposed approach in progressive confirmable chunks with recommended decisions and alternatives. Use when aligning on a design, plan, or technical approach before implementation.
argument-hint
file|folder

STARTER_CHARACTER = 🎯

Goal

Synchronize the mental model between you and the user before implementation begins. Discrepancies found during implementation are expensive — find them now while changes are free. Your job is to make your thinking visible so the user can spot where your understanding diverges from theirs.

Core Principle

Propose, don't ask. Think first, then present your thinking for confirmation. The user's job is to spot divergence and course-correct, not to generate the approach.

Flow — Zoom In

Each level deepens understanding. Confirm before going deeper.

Goal → Big Picture → Straightforward Details → Non-obvious Decisions (one by one)
1. Goal

State what you understand the goal to be and why it matters. A sentence or two. This catches the deepest misalignment — if you're solving the wrong problem, nothing else matters.

Confirm with AskUserQuestion before going deeper.

2. Big Picture

Present the overall shape of the approach: how do the pieces relate, what's the high-level flow. ASCII diagram. A few sentences, not a page.

Confirm with AskUserQuestion before going deeper.

3. Straightforward Details

Decisions where there's really only one reasonable approach. No ⭐/❌ needed since there are no real alternatives. The user confirms or flags exceptions.

Group items by topic. Anchor each group with an ASCII diagram — not just for file structures, but for any group: roles and their responsibilities, control flow, communication between components. The diagram is what makes a group scannable. Present one group at a time, confirm, move to the next group.

Each item: one line stating the decision. Save the "why" — it's obvious.

Show full SKILL.md (231 more words)Show less
4. Non-obvious Decisions

Decisions with real tradeoffs, multiple valid approaches, or where your recommendation might surprise the user.

First, present a brief index of what's coming — just the problem titles, no recommendations. This lets the user see the scope.

Then walk through each one (or small related groups) with:

  • The problem: what is being decided, why it matters
  • ⭐ Recommended approach with rationale
  • ❌ Alternatives considered with why they were rejected
  • ASCII diagram if the item involves structure or flow

Confirm each with AskUserQuestion before moving to the next.

When the user rejects a recommendation, check whether downstream items are affected. If so, flag which ones need revisiting.

After Corrections

When the user corrects something, re-present the full updated version (diagram, section, whatever was corrected) before asking to proceed. Don't just show the delta. The user needs to see the corrected whole — it often triggers additional corrections they wouldn't have noticed otherwise.

Anti-patterns

  • Jumping to detail-level decisions before establishing the big picture
  • Flat-listing many decisions without grouping by topic (user loses context)
  • Presenting the full detailed analysis for every item (save depth for non-obvious items only)
  • Asking open-ended questions instead of proposing (the user invoked this to see YOUR thinking)
  • Presenting a group of decisions without a visual anchor (diagram makes it scannable)
  • Offering redundant AskUserQuestion options that split the same intent
  • Continuing with pre-planned items after a redirect without reconsidering downstream impact

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

Files

Just SKILL.md in output_skills/design/align of lexler/skill-factory.

Open the folder on GitHubat commit 8017333

Compare with similar skills

Align 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.

Align compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Align this skilllexler/skill-factory239—~900Automated safety check: PassApache-2.0
Presentationsasgeirtj/system_prompts_leaks69k—~858Automated safety check: PassCC0-1.0
Geo Proposalsickn33/agentic-awesome-skills47k1 repos~3.2kAutomated safety check: NotesMIT
Better Proposals AutomationComposioHQ/awesome-claude-skills77k3 repos~764Automated safety check: PassNone
PresentationRightNow-AI/openfang18k—~829Automated safety check: PassApache-2.0
AI Presenter VideoNousResearch/hermes-agent252k—~2.3kAutomated safety check: PassMIT

Similar skills

  • Presentations

    asgeirtj/system_prompts_leaks

    Help choose a presentation's audience, story, outline, or use of evidence and visuals.

    69k GitHub stars~858 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Geo Proposal

    sickn33/agentic-awesome-skills

    Auto-generate a professional, client-ready GEO service proposal from audit data.

    47k GitHub starsUsed in 1 repo~3.2k tokens
    Sales & SupportAuto-check: notes
  • Better Proposals Automation

    ComposioHQ/awesome-claude-skills

    Automate Better Proposals tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~764 tokens
    Productivity & AutomationAuto-check passed
  • Presentation

    RightNow-AI/openfang

    Presentation expert for slide structure, storytelling, visual design, and audience engagement

    18k GitHub stars~829 tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • AI Presenter Video

    NousResearch/hermes-agent

    Produces a presenter-led video from a topic or script plus one authorized presenter image, with captions, lip-sync checks and acceptance reports.

    252k GitHub stars~2.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Contract And Proposal Writer

    alirezarezvani/claude-skills

    Generate professional, jurisdiction-aware business documents: freelance contracts, project proposals, SOWs, NDAs, and MSAs.

    28k GitHub starsUsed in 2 repos~3.4k tokens
    Legal & ComplianceAuto-check passed

More from lexler/skill-factory

All 25 skills in this repo
  • C4 Architecture Diagrams

    lexler/skill-factory

    Creates C4 model diagrams at every zoom level, from system landscape to code, in ASCII, Mermaid or Structurizr, for designing or documenting software architecture.

    239 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Launching Agent Teams

    lexler/skill-factory

    Plans and launches Claude Code agent teams with distinct roles, right-sized tasks and detailed spawn prompts, and says when subagents or worktrees fit better.

    239 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Claude Code Statusline Writer

    lexler/skill-factory

    Guides writing and debugging Claude Code status line scripts that read session JSON from stdin and print one line of text.

    239 GitHub stars~872 tokensUpdated 1 mo ago
    Auto-check passed
  • Catalog of obstacles, anti-patterns and patterns for working with AI coding agents, covering context management and reliability, from a published patterns collection.

    239 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Approval Testing Toolkit

    lexler/skill-factory

    Writes snapshot-style approval tests in Python, JavaScript, TypeScript or Java, comparing output against an approved file instead of writing individual assertions.

    239 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Hotspots

    lexler/skill-factory

    Find where a codebase actually costs time by mining its git history (Tornhill hotspot analysis).

    239 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Align

What does Align do?

Presents a proposed approach in progressive confirmable chunks with recommended decisions and alternatives. Align is an agent skill from lexler/skill-factory. Presents a proposed approach in progressive confirmable chunks with recommended decisions and alternatives.

When should I use Align?

Align fits situations like: aligning on a design; technical approach before implementation.

How do I install Align in Claude Code?

Run `npx skills add lexler/skill-factory --skill align -a claude-code`. Or copy the skill folder (output_skills/design/align in lexler/skill-factory) into .claude/skills/align in your project. Claude Code loads it when a task matches its description.

How do I install Align in Codex?

Run `npx skills add lexler/skill-factory --skill align -a codex`. Or copy the skill folder (output_skills/design/align in lexler/skill-factory) into .agents/skills/align in your project. Codex loads it when a task matches its description.

Can I use Align 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 lexler/skill-factory --skill align -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/align, .gemini/skills/align, .github/skills/align and .opencode/skills/align in your project.

What does Align need to run?

SKILL.md names no scripts, command-line tools or credentials: Align is instructions for the agent only.

Does Align 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 Align 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. Review the folder before installing.

What licence does Align use?

Align is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Align use?

About 900 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Align?

Skills that share tags, products or a category with Align: Presentations (asgeirtj/system_prompts_leaks, 69k stars), Geo Proposal (sickn33/agentic-awesome-skills, 47k stars), Better Proposals Automation (ComposioHQ/awesome-claude-skills, 77k stars) and Presentation (RightNow-AI/openfang, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Align?

lexler (a GitHub user) maintains it in lexler/skill-factory, which has 239 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on August 26, 2026.

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