Guide · Agent skill
How to use the Article Link Density Audit agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The article-links skill gives an AI agent a checklist rule for how many internal links (to your own pages) and external links (to authoritative outside sources) an article should contain. This guide explains what the skill makes the agent do, how to install it, how to ask for it in plain language, and what it needs and does not do. After reading, you will be able to install the skill and run a link-balance review on an article or template.
Article Link Density Auditthedaviddias/Front-End-Checklist · MIT Download the skill Quick start
- 1Download the ZIP. Download the article-links ZIP from this page.
- 2Unzip the folder. Unzip the download so you have an article-links folder containing SKILL.md and references/rule.md.
- 3Place the skill. Move the folder into ~/.claude/skills/ for personal use, or into .claude/skills/ in your project.
- 4Or upload it in the Claude apps. In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the ZIP.
- 5Ask for a review. Give the agent an article file, template or rendered HTML and ask it to check internal and external links.
- 6Apply the suggestions yourself. Review the suggested 2-3 internal and 1-2 external links and add the ones that fit the content.
What the article-links skill makes the agent do
An agent skill is a folder of instructions that an AI agent can load when a task matches it. This one covers optimizing article link density, which means checking that an article has a sensible balance of internal and external links for its length.
When you ask, the agent reviews the article content and related templates or rendered HTML for that balance. Where support is thin, it suggests adding 2-3 internal links to related content and 1-2 external links to authoritative sources that back up your claims.
- Checks the link balance of an article against the rule
- Reviews templates and rendered HTML for search-facing link output
- Suggests specific additions where links are thin
- Does not insert links or change your site on its own
Install the article-links skill
Download the article-links ZIP from this page and unzip it. Put the resulting folder in one of two places: ~/.claude/skills/ to make it available across your projects, or .claude/skills/ inside a single project to limit it to that project.
You can also upload the ZIP in the Claude apps. Go to Settings, then Capabilities, then Skills, and add it there.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload the ZIP
Trigger the skill with natural requests
You do not need a special command. Describe the task in ordinary words that mention articles, links or the page you want checked. The skill's description is about auditing article link density and verifying the rendered HTML and HTTP response, so requests about those topics are the ones it is built for.
Give the agent the article file, the template, or the URL's HTML so it has something real to check. The checks depend on the actual HTML or text.
- Review this blog post for internal and external links before I publish it.
- Check our article template for the link output search engines see.
- Audit this draft: does it have enough links to related guides and to authoritative sources?
Example: a link-balance review
A typical link in article markup looks like the example below. The agent looks at links like this one and counts internal links (paths on your own site such as /blog/mobile-optimization) against external links to other sites.
If the article has no internal links, or no external source backing a factual claim, the agent will point that out and suggest where 2-3 internal links or 1-2 external links could go.
<article>
<p>According to a recent study by <a href="https://example-authority.com/study" rel="noopener noreferrer" target="_blank">Industry Research Group</a>, 70% of users prefer mobile-friendly websites.</p>
<p>To help you optimize your site, check out our <a href="/blog/mobile-optimization">guide to mobile performance</a>.</p>
</article>What the skill needs and safety notes
The skill lists no requirements. It does not run scripts and does not use the network, so it only reads the content you give it and the files in the skill folder. Because it does not fetch pages itself, the agent can only check HTML or text it can actually read.
The skill is general SEO and content-quality guidance. The files give no measured impact on rankings, so treat its suggestions as editorial advice to judge yourself.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
- Licence: MIT
Tips for getting useful results
Ask for a review of one article at a time, and include the surrounding template if the links come from layout code. Ask the agent to name the exact file or route where a problem appears, since the skill's code review guidance asks for that.
Read each suggested link before adding it. Internal links should point to genuinely related content, and external links should go to sources that support the specific claim.
- Send the full article text or rendered HTML, not just a summary
- Ask for exact files or routes when the output is wrong
- Run a periodic pass on older articles, not only new ones
What people use it for
- Checking a blog post for related internal guides before publishing
- Reviewing an article template for the link markup search engines see
- Running a periodic link-quality pass across older documentation articles
- Finding factual claims that lack a supporting authoritative source
Frequently asked questions
How do I install the article-links skill?
Download the ZIP from this page and unzip it. Place the folder in ~/.claude/skills/ for personal use or in .claude/skills/ inside a project, or upload the ZIP in the Claude apps under Settings, then Capabilities, then Skills.
Do I need anything else installed to use it?
The skill lists no requirements. It does not run scripts and does not use the network, so you mainly need an agent that can read the article content or templates you give it.
Is the article-links skill free?
The skill is published under the MIT licence, as stated on this page. Check the licence file in the repository for the full terms.
Will the skill add links to my site automatically?
No. It is guidance that suggests adding 2-3 internal links and 1-2 external links where support is thin. You decide what to add and where.
Why does the agent need the actual HTML or text?
The skill's checks depend on the real article content or rendered HTML, not guesses. If the agent cannot read the page or template, it cannot judge the link balance.
How does this compare with other link checkers?
This skill is a content-quality checklist applied by an agent. It does not crawl sites or measure rankings, so for live link status or search performance you would need a different tool.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are an editor or front-end developer who wants an agent to review article link balance before publishing or during a periodic pass. Pick something else if you need automatic link insertion, verified ranking impact, or a tool that checks live link status by crawling your site.
Download the skill