Guide · Agent skill
How to use the SEO Content Brief Generator agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The SEO Content Brief Generator is an agent skill that turns a keyword or an existing page URL into a structured outline a writer can follow. This guide explains what an agent skill is, how to install the seo-content-brief skill, how to trigger it with plain requests, and what it needs and does not do. By the end you will be able to request a brief and know how to check the result.
SEO Content Brief GeneratorAgriciDaniel/claude-seo · MIT Download the skill Quick start
- 1Download the ZIP. Download the seo-content-brief skill ZIP from the directory page.
- 2Unzip into a skills folder. Extract the folder into ~/.claude/skills/ for personal use or the project's .claude/skills/ folder for one project.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 4Make a request. Ask in plain language, for example "content brief for [keyword]", including a URL or keyword and a page type.
- 5Review the brief. Check the outline, competitor table and gap list against your business and the topic's expertise needs.
- 6Add expert input. Fill in the trust signals and new value the brief asks for before the writer drafts the page.
What is an agent skill and what does this one do?
An agent skill is a folder of instructions and reference files that an AI agent loads when your request matches the skill's purpose. This one is named seo-content-brief and is designed for planning content before it is written.
Once installed, the agent can take a keyword or an existing page URL and produce a brief. The brief covers suggested section word counts, where the target keyword should go, what competitor pages are missing, and the trust signals the content needs. It is built from a page-type template and checks suggestions against the website's own services, so it does not propose topics the business cannot credibly write about.
- Competitor analysis of the top ranking pages, with gap scoring
- Per-section word count breakdowns
- Keyword placement guidance for headings and body text
- Page-type templates for service pages and other page types
- Improve-existing-page briefs as well as new-page briefs
How do you install the seo-content-brief skill?
Download the ZIP for the skill from the directory page. Unzip it so the seo-content-brief folder (containing SKILL.md) is placed in one of two locations. For a personal install, use ~/.claude/skills/. For a single project, use the .claude/skills/ folder inside that project.
If you use the Claude apps instead, you can upload the skill under Settings → Capabilities → Skills.
- Personal install: place the folder in ~/.claude/skills/
- Project install: place the folder in the project's .claude/skills/ folder
- Claude apps: upload the skill under Settings → Capabilities → Skills
How do you trigger the skill with natural requests?
You do not need a special command. The skill's description lists phrases that activate it. Ask for a brief in ordinary language using one of these phrasings, and include a keyword or URL and, optionally, a page type.
The skill's argument hint is [url-or-keyword] [page-type], so giving both a target and a page type gives the agent the most to work with.
- "content brief for [keyword]"
- "write a brief for [topic]"
- "service page brief for [service]"
- "blog brief for [topic]"
- "content outline for [URL]"
- "content plan for [keyword]"
What should you ask for? Examples
For a new page, give a keyword or topic. The agent uses your homepage or sitemap only for business context and builds the brief from scratch, focusing on competitive gaps the new page can fill.
For an existing page, give its URL. The agent fetches the page and separates sections to keep or strengthen from sections to add, and it advises against a full rewrite when targeted changes will do.
- New page: "Write a brief for emergency plumbing services in Sydney, service page"
- Improve mode: "Content brief for https://example.com/services/drainage, improve existing page"
- Blog: "Blog brief for how to choose a commercial roof coating"
What does the skill need, and what are its safety notes?
The skill needs the agent to be able to fetch web pages. It reads the target URL, the homepage and the sitemap. The files do not list any API keys or accounts. The skill does not run scripts, but it does use the network to fetch pages.
The skill produces written briefs only. It does not edit a live site or publish anything. Its suggestions are advice, not guarantees of rankings, and briefs on regulated or highly technical topics still need review by a subject expert before publication.
- Requires web access in the agent runtime
- No scripts are run by this skill
- Uses the network to read the target URL, homepage and sitemap
- Does not make changes to your website
- Not a ranking or publishing guarantee
Tips for getting better briefs
Give a specific keyword and page type. Name the business in the request if the homepage is unclear. Review every suggested topic against what your business actually offers, since the skill checks against the site but you know it best.
Treat the output as a starting outline for a writer. Add real expert input, first-hand experience and data the brief asks for, because the brief can specify what new value to add but cannot supply it.
- Be specific about the keyword and the page type
- Make sure the site's homepage or sitemap is reachable
- Check that suggested trust signals such as author credentials are things you can actually provide
- Have a subject expert review regulated or technical topics
What people use it for
- Planning a service page for a local business by checking competitor coverage against the site's own services
- Giving a freelance writer a clear outline with word counts and keyword placement before drafting
- Reviewing an existing blog post to decide which sections to keep, strengthen or add
- Preparing a hub page that links to every product category the site actually has
Frequently asked questions
How do I install the seo-content-brief skill?
Download the ZIP from the directory page and unzip it so the seo-content-brief folder sits in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder. In the Claude apps you can instead upload it under Settings → Capabilities → Skills.
Does the seo-content-brief skill need API keys or accounts?
The skill's files do not list any API keys or accounts. It does require the agent to be able to fetch web pages, since it reads the target URL, homepage and sitemap.
Is the seo-content-brief skill free?
The skill is released under the MIT licence, as stated in its LICENSE.txt file. The licence file does not list prices, so check the directory page for any other terms.
Does this skill run scripts or change my website?
The skill does not run scripts and it uses the network only to fetch pages. It produces written briefs and does not edit a live site.
What is the difference between new page mode and improve mode?
New page mode starts from a keyword or topic and builds a brief from scratch. Improve mode starts from an existing page URL and separates what to keep or strengthen from what to add.
Will following the brief guarantee rankings?
No. The brief is advice, and results depend on many factors outside the document. Regulated or highly technical topics still need subject-expert review before publication.
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
This skill suits content marketers, freelance writers and small business owners who want a clear, site-aware outline before drafting a blog post or service page. It is less suited to regulated or highly technical topics that need expert sign-off, or to anyone who wants automatic edits to a live website, in which case a different tool or a human editor is the better choice.
Download the skill