I will present you the way I constructed a high-quality content material automation system for the Ahrefs weblog utilizing Claude code and 23 ability recordsdata.
Again in August 2025, I shared the AI content material course of I developed for the Ahrefs weblog. Utilizing the ChatGPT mission and customized GPT, we sped up the creation of sure sorts of content material from days to hours, nevertheless it nonetheless required a variety of guide intervention.
Now, simply eight months later, we’re sharing our new course of. Generate publishable article drafts in 6 to 12 minutes utilizing a concatenation of code and 23 customized ability recordsdata. We printed about 15 articles and up to date about 30 extra with this new course of.
I’ve been utilizing AI to create content material advertising since 2020. It has helped me little by little with my efforts. However at this time, it is sufficient to automate essential components of content material advertising with out compromising high quality (even vital enhancements in some areas, similar to analysis). Or, as I stated in a latest article, there wasn’t sufficient AI content material. Now it’s.
In consequence, I proposed a fairly daring path in our inner Slack in February.
The present content material course of for AI is:
Watch this course of on YouTube
Try this episode aleph podcast Watch Tim Soulo, CMO of Ahrefs, demo our content material automation system.
Earlier than we get into it, I wish to remind you of some essential factors.
expertise is essential
AI content material just isn’t nice by default. This course of works as a result of it mirrors current human enhancing processes constructed from a long time of collective content material advertising expertise. Or as somebody amongst others LinkedIn comments To be very clear,
“Ryan’s SKILL file is nice as a result of he already knew what to place within the file. Most individuals utilizing a clean slate instrument do not have 13 years of enhancing expertise to construct from. The hole is not simply within the instrument, it is within the individual utilizing the instrument.”
Subject choice nonetheless issues
This course of particularly targets informational web optimization content material. I solely use this course of for matters that I perceive effectively. That means, you possibly can evaluation every article to confirm its claims, appropriate any misinformation, and be sure you’re pleased with the article being put out into the world.
It additionally primarily focuses on matters that Ahrefs already covers (in some capability), making a whole lot of current high-quality articles obtainable to make use of as reference factors for brand spanking new content material.
There aren’t any plans to make use of AI to “improve content material”
Utilizing this course of, you possibly can scale your Ahrefs weblog to tens of 1000’s of articles. I do not. It isn’t within the curiosity of Ahrefs or our prospects.
As an alternative, I exploit this workflow to keep up an evergreen library of helpful content material round just a few core matters. My aim is to take away the grunt work and focus our human grey matter on the components of promoting that profit us probably the most.
On the coronary heart of this course of are roughly 23 ability recordsdata that handle completely different components of the Ahrefs enhancing course of, from conducting key phrase analysis to matter hole evaluation to structural overviews.
Every ability file comprises a markdown-formatted clarification of how Claude (or any LLM) ought to run every course of, examples of greatest practices to emulate, and directions for formatting the anticipated output.
Many of those expertise are tailored from current course of documentation created by people. Some are written from scratch, whereas others are fully AI-generated and edited.
Any ability can be utilized alone, however I additionally created a foremost ability (blog-pipeline) This instructs LLM to set off every of those expertise in a particular order, and runs by means of all of the processes in sequence to show your key phrase thought right into a (practically) completed article.
In principle, the method would seem like this: Absolutely automated. Claude can use the ability file I created to set off a every day content material hole evaluation. Ahrefs MCP, review and prioritize the best keywords to target and get started throughout. blog-pipeline A workflow that notifies you when a new article draft is ready for review.
One of many dangers of agent-based content material creation is that if an article seems on the finish of a 10-minute run and the outcomes are unhealthy, it is troublesome to diagnose precisely the place and why the method went mistaken.
Subsequently, every step on this course of produces its personal output file. For instance, when an overview is generated, it’s handed to the following stage of the method, however saved as a markdown file within the outlines folder.
You may evaluation each stage of a course of, regulate its particular outputs (and corresponding ability recordsdata), and begin over from the final stage that meets your high quality requirements.
As LLM fashions develop into increasingly more succesful, we are sometimes stunned at how effectively frontier fashions excel at very particular duties, even when no particular directions or examples are offered. In some instances, a posh ability file is worse than giving the mannequin a one-sentence immediate and getting it out of the way in which.
We have been utilizing Anthropic’s Talent Creator expertise to check and enhance our workflows. skill Take a look at every step of the method, generate outlines, and discover primers and drafts with or with out steerage offered in customized ability recordsdata.
LLM critiques the output and suggests methods to enhance your ability file for extra constant outcomes.
Abilities recordsdata are typically lengthy and bloated, making it much less possible that steerage can be utilized accurately by the LLM. This course of lets you regularly shorten your expertise to their best essence and take away these which might be fully unrelated to your required outcomes.
This course of is completed by Claude Aleph MCP.
Instead of hallucinating fake SEO data, Claude can get keyword metrics, parent topics, and long-tail keyword variations for every article directly from Ahrefs.
Use the questions report to uncover common questions and group them into themes. Also, get an overview of the SERPs to understand key search intents and what types of content are ranking.
My skills file includes not only great SEO data, but also specific instructions for using other important data sources, such as:
- Competitor data: Important topics, headers, and content gaps are extracted from articles that rank highly for the same keywords.
- Deep investigation: Review reliable news and research sources to see the latest information on your target keywords.
- Product features: LLMs have access to an overview of all Ahrefs products and features stored in Markdown documents, along with the most important use cases.
By default, LLM is a very convincing bloviator. You can generate content that sounds consistent without including specific data or content. Mandating the use of specific data sources is key to achieving good results.
Get Ahrefs data with AI tools
Ahrefs API and MCP are now available on all paid plans starting with Lite, making it easier than ever to get world-class Ahrefs SEO and AEO data in your dashboards, apps, or content workflows.
Need some inspiration to get started? Read this: 15 Ahrefs MCP Use Cases for SEO and Digital Marketers
Beforehand, most AI content material processes have been frontloading human enter. My principle is that professional instruction is offered piece by piece. begin A lot of the content material creation course of is rather more efficient than human enhancing on the finish.
I wished to go on this path with out having to create a full-fledged content material define, so I made a decision to make use of the context parameter as blog-pipeline Abilities that may present context for customers to information them by means of the content material creation course of.
If you wish to generate an article about “Content material Hole Evaluation”, you possibly can add tough directions like this:
“By way of ‘stealing your opponents’ greatest content material,’ we’ll give attention to Key phrase Explorer’s content material hole instrument and embrace a bit to seek out quick-win key phrases that your opponents are rating for, however you are not.”
I exploit this to say particular subtopics to cowl, overarching angles and feelings to form the article, and particular product options to say. This context is saved in a devoted file and used as a reference to your drafting expertise.
I learn each article posted on the Ahrefs weblog phrase for phrase. Studying Markdown recordsdata in VS Code by no means looks like a superb time, so I exploit a easy ability to transform every generated article into an Ahrefs-style HTML preview that robotically opens in Chrome.
complement.
As you possibly can see from the picture above, photographs in weblog posts are nonetheless not a solved drawback. I am presently experimenting with a ability that triggers a headless browser that lets you navigate to a particular Ahrefs report, take a screenshot, annotate it, and insert it into an article draft.
We’re additionally experimenting with interactive previews that will let you approve or reject updates to current content material and depart inline feedback prompting Claude to take motion. At this level, we have strayed into the realm of great functions. So keep tuned for v3 of my content material course of.
When you’re pleased together with your article draft and able to add and add photographs, set off the ultimate ability that codecs the article with all the right tables and shortcodes wanted.
This content material course of is constructed to my private specs. I check with a few of my favourite articles to assist form the tone and magnificence of every article. Favourite knowledge sources take priority. And most significantly, it is constructed to mirror my writing course of and method content material creation in a means that matches how my mind works.
Nonetheless, there isn’t any “greatest” strategy to create content material. Even the Ahrefs Weblog workforce has a wealth of various kinds, settings, and workflows that form how we create content material.
We would like our AI content material course of to mirror all of our idiosyncrasies, so we inspired groups to fork this repository and modify it to their very own specs utilizing Claude Code, add and take away steps within the course of, change the information sources and reviews they use, and study from the model and voice of their very own greatest articles.
The aim is for everybody on the workforce to have their very own content material co-pilot, working to their specs and taking part in to their strengths.
future
When you observe the Ahrefs weblog, you most likely have not observed any main modifications, although we’re utilizing generative AI to assist with increasingly more jobs.
That is as a result of we’re not utilizing AI to “scale up outcomes” and publish 1000’s of articles, and we’re not buying and selling off velocity for high quality. As an alternative, we use it to automate probably the most routine components of labor, and solely in conditions the place AI can do the job as effectively or higher than a talented human.
AI can assist you fill content material gaps and replace your evergreen library of searchable content material. Within the meantime, the Ahrefs Weblog workforce can use their vitality in different methods, together with conducting analysis and writing thought management, internet hosting webinars and talking in-person, and constructing programs to additional automate probably the most tedious components of our lives.
Whereas there may be a variety of fear-mongering surrounding AI and content material creation, this can be a lot of enjoyable.
PS I’ve already constructed model 3 of this content material system. That is one thing you should use too. Be a part of this waitlist to get early entry.
