agentleFS
FracteraFractera/Agent-Engineering-Infrastructure/.claude/skills/use-links/SKILL.md

use-links

Skill68 starsChanged 2 days agoMITView on GitHub

LINKS — what this project does differently about them. Load it when you write body text with links, add a button or card that points somewhere, or the owner says "link these pages", "add a source", "mention their site". Short on purpose: link attributes, anchor text and interlinking practice you already know. Two things you cannot know are here — an outgoing link is the architect's decision, not yours, and this engine has its own written form for internal links, with a gate behind it.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No answer yet? Write the fact and name the source in words.

    line 21

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

use-links

Informational, not binding. Know a better way for the case in front of you — do it your way and say so. You are trusted with the creative work on this project.

1. Outgoing links belong to the architect

An external link hands part of this site's search weight to somebody else and invites the reader to leave. That is his call, not a technical detail — name what you would link and why, and ask.

No answer yet? Write the fact and name the source in words. A source can be credited without a link, and a link can be added in one edit later.

You may act without asking when it is not a new decision: he gave you the URL, the target is this project's own domain, or you are repairing a dead link to the same destination.

2. Two written forms for internal links — the engine enforces both

FormWhat it is
[%SITE%](/ru)the site root, in the language of that cell. The label is the literal token %SITE%, replaced at render with the site's name from APP-CONFIG. Every language cell carries one
[любая подпись](/ru/about-us)another page of this same site. Label is free — a page's name belongs to the material

Both resolve through lib/content/sections/links.ts, which also strips the language segment in single-language mode — a hand-glued address answers 301 there.

Why not a plain relative link: material travels between projects, and /pricing in another project means a different page or none. So the gate verifies the target route exists here and is public — check:content, rule page-link-missing. A link into the protected layer is refused: a public link to a 403 is a promise the site does not keep.

🔒 Where the interlinking should point is a product question, and the answer is not yours. Read development-docs/PASSPORT.md — §1, §2 and §6 say what this product is for and what furniture carries its navigation. Where it is silent, follow the architect's direct instruction on what links where, and do not invent a web of cross-links because SEO advice says to.

3. What the gates catch

check:content — a relative link outside the two forms, a root link whose label is not %SITE%, a cell with no link home (counted per file), a page link with no such public page.

None of them can tell whether a destination still exists on the internet. Request each external URL once, and list the ones you added in your report — that list is what the architect approves.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.