Guide · Agent skill
How to use the Author Markup Auditor agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Author Markup Auditor is an agent skill that tells an AI agent how to check whether your article pages expose author information as machine-readable JSON-LD structured data, so search engines can identify who wrote the content. This guide explains what the skill makes the agent do, how to install it, how to ask for an audit in plain language, and what to watch for. By the end you will know how to run an author markup check on your templates and pages and how to read what the agent reports back.
Author Markup Auditorthedaviddias/Front-End-Checklist · MIT Download the skill Quick start
- 1Download the ZIP. Get the author-info skill ZIP from this page.
- 2Unzip the skill. Unzip it into ~/.claude/skills/ for personal use or into your project's .claude/skills/ folder.
- 3Or upload it in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill there.
- 4Ask for an audit. Describe the task in plain words, naming the templates, routes or URL you want checked for author markup.
- 5Review the findings. Check the flagged routes and the suggested Person or Organization schema against your real author details.
- 6Verify the rendered output. Reload the page or inspect its rendered HTML and HTTP response to confirm the JSON-LD is present after changes.
What is an agent skill and what does this one do?
An agent skill is a folder of instructions that an AI agent loads when a task matches the skill's description. This one comes from the Front-End Checklist project, under the path skills/author-info, and is licensed under MIT.
When you ask for it, the agent reviews your templates, rendered HTML and HTTP responses for author markup. It flags pages where author markup is missing or wrong and suggests adding a Person or Organization schema linked to the article's author property.
- Checks for JSON-LD structured data that identifies the author
- Looks at metadata generation, rendered HTML, structured data and response headers
- Flags exact routes or templates that violate the rule
- Suggests a Person or Organization schema connected to the author property of an Article or WebPage
Install the Author Markup Auditor skill
Download the skill ZIP from our page and unzip it. You can install it in one of two places. For a personal setup, unzip it into ~/.claude/skills/. For a single project, unzip it into the project's .claude/skills/ folder.
If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.
- Personal: ~/.claude/skills/
- Per project: .claude/skills/ inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload
Trigger the skill with natural requests
The skill's description covers auditing metadata, crawlability, structured data and indexability related to author markup. You do not need a special command. Describe the task in ordinary words and mention authors or structured data so the agent picks up the skill.
Point the agent at real files or URLs where you can. The skill asks for the rendered HTML and HTTP response, not only the source templates, so a page that is built or altered at runtime is checked as it is served.
- Check the article template in this project for author JSON-LD and tell me which routes lack it.
- Audit author markup on https://example.com/blog/my-post. Compare the rendered HTML with the template.
- Review our metadata templates before launch and flag any Article pages without a Person or Organization author.
What the audit looks at and what it suggests
The skill's check step asks the agent to confirm that each page includes structured data identifying the author with relevant metadata. The recommended properties include name, url, sameAs and jobTitle, and the Person or Organization schema should be linked to the author property of your content.
The skill's example uses a Person with a name, jobTitle, url, sameAs profile links and a worksFor Organization. Treat that as a template to adapt, and only use details that are true for your real authors. The skill explains that sameAs links help search engines connect an author to their other profiles.
- name, url, sameAs and jobTitle are the properties the skill lists
- Person or Organization schema is linked to the author property
- Verify the final output in the rendered page, not just the source file
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Jane Smith",
"url": "https://example.com/authors/jane-smith"
}
</script>What the skill needs and its safety notes
The skill lists no requirements. It does not run scripts and it does not use the network. That means the agent works from the files and pages you give it, and the skill itself does not make requests on your behalf. The skill's files are SKILL.md and references/rule.md.
Only put real, verifiable author identities into structured data. Publishing fake or unverified author details can mislead search engines and users.
- Requires: nothing listed
- Runs scripts: no
- Uses network: no
- Files: SKILL.md and references/rule.md
What people use it for
- Finding article templates on a blog that never output author JSON-LD
- Checking that a rendered post page contains a Person schema linked to its author
- Reviewing metadata templates before a site launch
- Confirming that author details like sameAs profile links match the real author
Frequently asked questions
How do I install the author-info agent skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps you can instead upload it under Settings → Capabilities → Skills.
Does the author-info skill cost money or what is its licence?
The skill is listed under the MIT licence. The source material does not mention any price, so check the repository for licence terms before reusing it.
What does the skill require to run?
The skill lists no requirements. It does not run scripts and does not use the network, so it works from the templates, rendered HTML and responses you provide.
Will adding author markup improve my search rankings?
The skill says author markup can benefit rankings, but this is a general SEO claim that the skill's files do not verify. Treat author markup as a way to make authorship clear to search engines rather than a guaranteed ranking gain.
Which properties should author markup include?
The skill recommends name, url, sameAs and jobTitle in a Person or Organization schema, linked to the author property of your Article or WebPage. Use only details that are accurate for the real author.
Why does the agent check rendered HTML instead of only source files?
The skill's description says to verify the rendered HTML and HTTP response rather than relying only on source files, because the output a search engine sees is what matters.
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 maintain a blog or content site and want an agent to check whether article pages expose real author details as JSON-LD, or if you are auditing templates before launch. Pick something else if your site has no authored content, or if you expect author markup alone to guarantee ranking gains.
Download the skill