New: 97,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

Align Docs

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Align stale repository docs and task records; use --clean for a full documentation cleanup.

Apache-2.0Auto-check: notes

Install Align Docs

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill align-docs -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins align-docs --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/reidemeister94/development-skills/skills/align-docs .claude/skills/align-docs && 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-docs
GitHub stars
1.2k
Token cost
~991 tokens
SKILL.md length
433 words
Files
3 (incl. references)
Skills in repo
736
Repo updated
First seen
Licence
Apache-2.0

At a glance

Align stale repository docs and task records; use --clean for a full documentation cleanup.

  • SKILL.md covers Entry layer, Owners and evidence, Lifecycle and routes and Check
  • Calls git and uv

What it does

Align Docs is an agent skill from hashgraph-online/awesome-codex-plugins. Align stale repository docs and task records; use --clean for a full documentation cleanup.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/agents-template.md` and `references/clean-mode.md`).

The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

Example prompts

  • “/align-docs”

Requirements

  • Pre-approved tools (allowed-tools): Read, Edit, Write, Bash, Glob, Grep, AskUserQuestion

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Edit
    • Write
    • Bash
    • Glob
    • Grep
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use git and uv, which can reach the network depending on how they are called.

    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 Docs loads about 991 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 26 tokens; SKILL.md has 433 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Edit, Write, Bash, Glob, Grep, AskUserQuestion

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 hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its Apache-2.0 licence (© hashgraph-online). 433 words, ~991 tokens.

Download SKILL.mdSave it as .claude/skills/align-docs/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
align-docs
description
Align stale repository docs and task records; use --clean for a full documentation cleanup.
allowed-tools
Read, Edit, Write, Bash, Glob, Grep, AskUserQuestion
user-invocable
true

Align docs

Make existing repository knowledge accurate and easy to find. Continue an active workflow with its current task context and authorization. Without task context, inspect only the entry layer and relevant references. Exclude dependencies, caches, build output, and vendored content.

Entry layer

Preserve or establish the project's shared entry layer:

text
README.md                 # Human entry point.
AGENTS.md                 # Critical facts and scoped rules, under 70 lines.
CLAUDE.md                 # Exactly @AGENTS.md.
.agents/rules/            # Scoped project rules; .gitkeep if empty.
.claude/rules -> ../.agents/rules
docs/ATLAS.md             # Curated knowledge routes.

Inspect these files, manifests, relevant agent memory, and documents affected by the current task. Report conflicts or missing facts before making safe in-scope repairs. A normal run never merges or deletes first-party documents and does not scan unrelated history for archive candidates. Use clean mode for a requested full-corpus cleanup.

Owners and evidence

Give each fact one owner: critical facts in AGENTS, scoped instructions in rules, execution in plans, reasons in chronicles. Keep other useful knowledge in its clearest existing home. Verify implementation claims against code and tests, runtime claims against telemetry, promises against contracts, and decision reasons against chronicles. Report unresolved conflicts instead of choosing an unsupported claim.

Preserve an existing AGENTS file's rules. Edit them only within the task's authorization; do not overwrite it with a template. Use agents-template.md only when creating or explicitly migrating the file. Remove a leftover align-docs:principles-customized marker. Keep personal machine facts in .claude/CLAUDE.md or global Codex instructions. Ensure .gitignore ignores .claude/CLAUDE.md and AGENTS.override.md. Capture lasting session facts absent from disk; with no session context, report CAPTURE: NONE.

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

Lifecycle and routes

Use the documentation contract for metadata and lifecycle. Archive only documents whose changed lifecycle the task establishes:

  • Completed plans with closed work and verified implementation move to docs/plans/archive/.
  • Superseded or obsolete chronicles move to docs/chronicles/archive/ with decision prose preserved.
  • Other obsolete documents with useful history move to an adjacent archive/.

Keep current owners and uncertain documents active. Move durable instructions to their owner before archiving. Use git mv for tracked files. Repair inbound links, moved-file links, paired IDs, and archive metadata.

Build ATLAS without frontmatter. Route recurring questions to authoritative files with a link and a when-to-read sentence. List small curated scopes, such as rules and reference notes, completely. Give plans and chronicles one directory route that explains YYYY-MM-DD__<slug>.md and legacy NNNN__ names. Exclude fixtures, implementation-support Markdown, ATLAS itself, and lifecycle tables.

Check

Check the entry layer, scopes, symlink, ignored files, manifest claims, ATLAS routes, changed metadata, and Markdown links. Run uv run <plugin-root>/scripts/check_docs.py <repository-root> from the installed plugin. Use the project's documented --legacy-before YYYY-MM-DD cutoff when present. The checker validates local file targets, paired IDs, names, and plan closure; it does not validate heading anchors or external URLs. Report unrelated failures without expanding scope or claiming success. Apply the authoring contract to changed instructions.

© hashgraph-online, 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

SKILL.md and 2 other files (references) in plugins/reidemeister94/development-skills/skills/align-docs of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/agents-template.md
  • references/clean-mode.md

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Align Docs 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 Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Align Docs this skillhashgraph-online/awesome-codex-plugins1.2k—~991Automated safety check: NotesApache-2.0
Recordingcodewhale-hq/Codewhale41k—~540Automated safety check: PassMIT
Architecture Decision Recordsaffaan-m/ECC274k4 repos~1.8kAutomated safety check: PassMIT
Architecture Decision Recordsaffaan-m/ECC274k1 repos~863Automated safety check: PassMIT
Architecture Decision Recordsaffaan-m/ECC274k—~1.1kAutomated safety check: PassMIT
Ccs Alignthedotmack/claude-mem97k—~6.1kAutomated safety check: PassApache-2.0

Similar skills

  • Recording

    codewhale-hq/Codewhale

    Capture screenshots on registered computers, record on macOS or HarmonyOS, and manage saved captures.

    41k GitHub stars~540 tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Architecture Decision Records

    affaan-m/ECC

    Capture architectural decisions as numbered ADR markdown files in docs/adr/ with context, alternatives considered, consequences, and an index README.

    274k GitHub starsUsed in 4 repos~1.8k tokens
    DevelopmentAuto-check passed

  • Architecture Decision Records

    affaan-m/ECC

    在Claude Code会话期间，将做出的架构决策捕获为结构化的架构决策记录（ADR）。自动检测决策时刻，记录上下文、考虑的替代方案和理由。维护一个ADR日志，以便未来的开发人员理解代码库为何以当前方式构建。

    274k GitHub starsUsed in 1 repo~863 tokens
    DevelopmentAuto-check passed

  • Architecture Decision Records

    affaan-m/ECC

    コーディングセッション中にアーキテクチャ決定を構造化ADRとして記録し、自動的に決定の瞬間を検出し、コンテキスト、検討された代替案、根拠を記録します。今後の開発者がコードベースの形成理由を理解するためのADRログを維持します。

    274k GitHub stars~1.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

  • Ccs Align

    thedotmack/claude-mem

    Run the CCS Align seat's hourly breathing cycle — prove the local claude-mem worker is healthy, pull needle observations through search → timeline → getobservations, land them in a seat-owned middle…

    97k GitHub stars~6.1k tokensUpdated today
    Auto-check passed

  • Data Clean

    brycewang-stanford/Auto-Empirical-Research-Skills

    Produce documented data cleaning scripts that log every transformation with N before/after each step, generate a CONSORT-style exclusion flow diagram, create decision log entries for every…

    4.5k GitHub stars~1.1k tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 skills in this repo

  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated yesterday
    Auto-check passed

  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed

  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed

Questions about Align Docs

What does Align Docs do?

Align stale repository docs and task records; use --clean for a full documentation cleanup. Align Docs is an agent skill from hashgraph-online/awesome-codex-plugins. Align stale repository docs and task records; use --clean for a full documentation cleanup.

How do I install Align Docs in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill align-docs -a claude-code`. Or copy the skill folder (plugins/reidemeister94/development-skills/skills/align-docs in hashgraph-online/awesome-codex-plugins) into .claude/skills/align-docs in your project. Claude Code loads it when a task matches its description.

How do I install Align Docs in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill align-docs -a codex`. Or copy the skill folder (plugins/reidemeister94/development-skills/skills/align-docs in hashgraph-online/awesome-codex-plugins) into .agents/skills/align-docs in your project. Codex loads it when a task matches its description.

Can I use Align Docs 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 hashgraph-online/awesome-codex-plugins --skill align-docs -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-docs, .gemini/skills/align-docs, .github/skills/align-docs and .opencode/skills/align-docs in your project.

What does Align Docs need to run?

Going by SKILL.md and its folder, Align Docs needs the command-line tools its instructions call (git and uv). Its frontmatter pre-approves these tools: Read, Edit, Write, Bash, Glob, Grep, AskUserQuestion.

Does Align Docs access the network?

SKILL.md contains no URLs. Its commands use git and uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Align Docs safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Align Docs use?

Align Docs 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 Docs use?

About 991 tokens (SKILL.md is roughly 4k 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 985 tokens, read only when the agent opens those files.

What are the alternatives to Align Docs?

Skills that share tags, products or a category with Align Docs: Recording (codewhale-hq/Codewhale, 41k stars), Architecture Decision Records (affaan-m/ECC, 274k stars), Architecture Decision Records (affaan-m/ECC, 274k stars) and Architecture Decision Records (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Align Docs?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.