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

Agents Md Symlink

by pdparchitect in pdparchitect/noodle

Every AGENTS.md must have a sibling CLAUDE.md symlink pointing to it.

Apache-2.0Auto-check passedAgent Workflows

Install Agents Md Symlink

skills CLI
$ npx skills add pdparchitect/noodle --skill agents-md-symlink -a claude-code

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

GitHub CLI
$ gh skill install pdparchitect/noodle agents-md-symlink --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/pdparchitect/noodle.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agents-md-symlink .claude/skills/agents-md-symlink && 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
agents-md-symlink
GitHub stars
158
Token cost
~430 tokens
SKILL.md length
191 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

Every AGENTS.md must have a sibling CLAUDE.md symlink pointing to it.

  • Deleting an AGENTS.md
  • SKILL.md covers Create, Keep in step and Verify
  • Calls git
  • CLAUDE.md file in any directory

What it does

Agents Md Symlink is an agent skill from pdparchitect/noodle. Every AGENTS.md must have a sibling CLAUDE.md symlink pointing to it. Use when creating, moving, renaming or deleting an AGENTS.md or CLAUDE.md file in any directory, or when auditing agent instruction files.

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

It sits in Agent Workflows, covering Agent instruction files. The licence is Apache-2.0.

When your agent uses it

  • Deleting an AGENTS.md
  • CLAUDE.md file in any directory
  • Auditing agent instruction files

Example prompts

  • “/agents-md-symlink”

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

Agents Md Symlink loads about 430 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 191 words of instructions outside code blocks.

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

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 pdparchitect/noodle at commit 76cf738, republished under its Apache-2.0 licence (© pdparchitect). 191 words, ~430 tokens.

Download SKILL.mdSave it as .claude/skills/agents-md-symlink/SKILL.md (or your agent's skills folder).
name
agents-md-symlink
description
Every AGENTS.md must have a sibling CLAUDE.md symlink pointing to it. Use when creating, moving, renaming or deleting an AGENTS.md or CLAUDE.md file in any directory, or when auditing agent instruction files.

AGENTS.md is the single source of agent instructions. Claude Code reads only CLAUDE.md, so every directory that has an AGENTS.md also needs a CLAUDE.md that is a relative symbolic link to it. Never keep a second copy of the text, and never write an import stub instead of a link.

Create

Run from the directory that holds the AGENTS.md:

sh
ln -s AGENTS.md CLAUDE.md

The target must be the bare filename. Git stores the target verbatim, so an absolute path breaks on every other checkout.

If a regular CLAUDE.md already exists, read it first. Merge anything that is not already in AGENTS.md, then replace the file with the link.

Keep in step

  • Edit AGENTS.md only. Writing through CLAUDE.md works, but replacing it with a regular file silently breaks the link.
  • When an AGENTS.md is moved, renamed or deleted, do the same to its link.
  • When the directory is a build-system source folder, give CLAUDE.md the same exclusion AGENTS.md has, so it is not treated as a source or resource file.

Verify

List every AGENTS.md whose sibling link is missing or wrong:

sh
find . -name AGENTS.md -not -path './.git/*' -not -path './.build/*' | while read -r f; do
  d=$(dirname "$f")
  [ "$(readlink "$d/CLAUDE.md")" = "AGENTS.md" ] || echo "missing or wrong: $d/CLAUDE.md"
done

Git must record the link as a symlink, mode 120000:

sh
git ls-files -s -- '*CLAUDE.md'

© pdparchitect, 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 .agents/skills/agents-md-symlink of pdparchitect/noodle.

Open the folder on GitHubat commit 76cf738

Compare with similar skills

Agents Md Symlink 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.

Agents Md Symlink compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agents Md Symlink this skillpdparchitect/noodle158—~430Automated safety check: PassApache-2.0
Using Agent Skillsaddyosmani/agent-skills104k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.8k2 repos~627Automated safety check: PassMIT
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Writing For Agentsbestofjs/bestofjs3.1k18 repos~2.7kAutomated safety check: PassMIT
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~11kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    104k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed

  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.8k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed

  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 18 repos~2.7k tokens
    Agent WorkflowsAuto-check passed

  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~11k tokens
    Agent WorkflowsAuto-check passed

  • SkillOpt Sleep Cycle

    microsoft/SkillOpt

    Official

    Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.

    18k GitHub stars~2.3k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

More from pdparchitect/noodle

All 8 skills in this repo

  • Version Bound Cleanup

    pdparchitect/noodle

    Gating migrations and clean-up code behind an update milestone.

    158 GitHub stars~650 tokensUpdated today
    Auto-check passed

  • UI Copy

    pdparchitect/noodle

    Rules for user-visible text and controls in the Noodle apps.

    158 GitHub stars~486 tokensUpdated today
    Auto-check passed

  • Helper Visibility

    pdparchitect/noodle

    Dock and app-switcher policy for Noodle helpers. An agent skill from pdparchitect/noodle.

    158 GitHub stars~267 tokensUpdated today
    Auto-check passed

  • Mint Release

    pdparchitect/noodle

    Procedure for minting or publishing a version of Noodle, Computer, Applet, Browser, Hub or the Computer images.

    158 GitHub stars~278 tokensUpdated today
    Auto-check passed

  • No Code Docs

    pdparchitect/noodle

    Code is documented only in the source. An agent skill from pdparchitect/noodle.

    158 GitHub stars~342 tokensUpdated today
    Auto-check passed

  • Apple History Utilities

    pdparchitect/noodle

    Upkeep of the Apple utilities copied into NoodleAppleRuntime.

    158 GitHub stars~149 tokensUpdated today
    Auto-check passed

Categories

Questions about Agents Md Symlink

What does Agents Md Symlink do?

Every AGENTS.md must have a sibling CLAUDE.md symlink pointing to it. Agents Md Symlink is an agent skill from pdparchitect/noodle.md symlink pointing to it.

When should I use Agents Md Symlink?

Agents Md Symlink fits situations like: deleting an AGENTS.md; CLAUDE.md file in any directory; auditing agent instruction files.

How do I install Agents Md Symlink in Claude Code?

Run `npx skills add pdparchitect/noodle --skill agents-md-symlink -a claude-code`. Or copy the skill folder (.agents/skills/agents-md-symlink in pdparchitect/noodle) into .claude/skills/agents-md-symlink in your project. Claude Code loads it when a task matches its description.

How do I install Agents Md Symlink in Codex?

Run `npx skills add pdparchitect/noodle --skill agents-md-symlink -a codex`. Or copy the skill folder (.agents/skills/agents-md-symlink in pdparchitect/noodle) into .agents/skills/agents-md-symlink in your project. Codex loads it when a task matches its description.

Can I use Agents Md Symlink 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 pdparchitect/noodle --skill agents-md-symlink -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agents-md-symlink, .gemini/skills/agents-md-symlink, .github/skills/agents-md-symlink and .opencode/skills/agents-md-symlink in your project.

What does Agents Md Symlink need to run?

Going by SKILL.md and its folder, Agents Md Symlink needs the command-line tools its instructions call (git).

Does Agents Md Symlink access the network?

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

Is Agents Md Symlink 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 Agents Md Symlink use?

Agents Md Symlink 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 Agents Md Symlink use?

About 430 tokens (SKILL.md is roughly 1.7k 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 Agents Md Symlink?

Skills that share tags, products or a category with Agents Md Symlink: Using Agent Skills (addyosmani/agent-skills, 104k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.8k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars) and Writing For Agents (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agents Md Symlink?

pdparchitect (a GitHub user) maintains it in pdparchitect/noodle, which has 158 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 10, 2026.

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