The AI Wardley Mapping Strategist skill for Claude
You describe your business, product or service in a few sentences and Claude builds a Wardley Map of it: your user's need at the top, everything that need leans on below it, and every component placed on the evolution axis from Genesis to Commodity. Then comes the real work, and the skill does that without asking anything further: strategic moves ordered by urgency, a forecast of what will shift in the coming years, and a warning about which assumptions in your business will get in the way. Build or buy stops being a gut feeling the moment it sits on a map.
the lines above come from the zip on this page · SKILL.md is 12,063 bytes
A business in, a map out
reg. W.001This is the example that sits in the SKILL.md itself, shown here step by step: an SEO agency that wants to know where its edge sits. The input is three sentences. It runs the six steps on that input, from the anchor to the inertia check, and delivers at the end not an opinion but a map with moves you can walk through.
What the AI Wardley Mapping Strategist is
The AI Wardley Mapping Strategist is a free skill from the library of 100 skills that we make available from the AI and automation service. A skill is an instruction file, SKILL.md, that gives an AI assistant a fixed method for one task. No software, no account, no connection: one text file of 1,860 words that teaches Claude how to apply the mapping method of Simon Wardley to your business, product or service. What a skill is exactly and how that works technically you can read in what Claude skills are; this page is about what this particular skill does and why you would want it.
The problem it solves is familiar to anyone who has ever had to make a strategic choice: build or buy, invest or outsource, hold on or let go. Most of those choices are made on gut feeling, in a meeting, with the most confident voice as the winner. Wardley Mapping replaces that gut feeling with a map.
Two axes do the work. The vertical axis shows your value chain: what the user sees at the top, the invisible infrastructure at the bottom. The horizontal axis shows evolution: every component moves from Genesis, new and not understood, through Custom Built and Product to Commodity, fully standardised. On a map you see at a glance what your moat is, what you should buy instead of build, and where the market is shifting underneath you.
It is based on the work of Simon Wardley, who has made his method freely available online under Creative Commons since 2015, and builds on the doctrine and gameplay principles from his book about topographical intelligence in business. The file states that provenance itself, with a source list. So you get no summary of a management book but a workable instruction: six steps, with the questions the skill asks per step, the signals it watches for and the fixed format in which the result appears.
One thing up front: the skill is strict. One user, one primary need, at least eight components, and every stage estimate is tested with the question whether you could buy the component elsewhere. That strictness is not a quirk but the whole point, because a vague map gives vague strategy.
Why a map beats a list
Most strategy documents are lists: strengths, weaknesses, opportunities, threats, action points. Lists have one fundamental problem: they show no position and no movement. You know you do seven things, but not how those things depend on each other and which way they are moving. A SWOT analysis is a photograph; a Wardley Map is a map of the terrain with a weather forecast attached.
The map shows dependencies. In step three the skill connects every component with what it needs in order to function. That sounds administrative, until you see what it lays bare: the service your clients pay for leans on a component you never give any attention, or on a freelancer who could walk out tomorrow. A component hanging off nothing is, according to the doctrine of the skill, suspect: either it is not part of your value chain, or you have forgotten a dependency.
The map shows evolution, and evolution is not optional. On that point the file is firm: components cannot stand still. The evolutionary pressure is universal, everything moves from Genesis to Commodity. The question is not whether your custom built solution will ever become a product anyone can buy, but when, and what you do at the moment it happens. Anyone who sees that coming on a map can react years earlier than someone who only notices when revenue drops.
The map makes inertia visible. Every analysis closes with inertia warnings: which assumptions in your organisation are still attached to an old position on the map. "We build everything ourselves" was an advantage while the component was custom; it becomes a cost the moment the same component is on sale as a product. Inertia is, according to the file, the most important reason companies lose when a component evolves. That is exactly the kind of warning you would rather get from a map than from your annual figures.
In diff form, with lines pointing to the example from the skill: how the same question sounds without a map and with one.
Two axes, everything visible
reg. W.002Here is the SEO agency from FIG.01 again, redrawn as the skill delivers it in text. Vertically the value chain: what the user sees sits high, infrastructure sits low. Horizontally the four evolutionary stages. The dotted lines are the dependencies from step three. Note the two marked points: the green component at the top left is the new opportunity in Genesis, the red one is the place where inertia is going to hurt.
What is really in the SKILL.md
A skill is only as good as its instructions, so we simply describe them here. The file opens with frontmatter that decides when Claude picks the skill up: not only at "make a Wardley Map", but also at questions such as what should I build myself and what should I buy, where is my moat, what does my value chain look like, or which part of my business has become a commodity. Ask something like that while the skill is installed and you get it automatically. How you build such an instruction file yourself is in writing a SKILL.md.
Then follow the six steps. Step one sets the anchor: who is the end user and what is their most important need. Here it is strict: one user, one primary need, because without a correct anchor the rest is worth nothing. Step two collects components: activities, practices, data, knowledge and technology, and the instruction says literally that it does not stop before at least eight are on the table, because an empty map says nothing. Step three draws the dependencies: which component needs which other component, with the user need at the top and every layer below it connected.
Step four places every component on the evolution axis, and this is where the file gets most concrete. Per stage, the signals by which you recognise it are written out. Genesis: few players, no price point, hype and uncertainty, papers on arXiv. Custom: companies build their own versions, consultants sell implementations, scarce talent. Product: SaaS solutions appear, different price points, comparisons on G2. Commodity: utility pricing, little differentiation, focus on reliability and cost. And because almost everyone rates their own work as too innovative, the skill adds a test question: can I buy this elsewhere?
Step five is the only step in which the skill asks you nothing: it does the gameplay itself. On the basis of the map it decides which teams belong with which components according to the three-way split Pioneer, Settler and Town Planner, walks through six classic strategic moves from Wardley's doctrine, and checks for inertia: organisational attachment to an old position. Step six delivers the output in a fixed format of seven parts: the anchor, the map in text, a components table with visibility and stage, strategic moves with the reason and the first step this week per move, climatic forecasts for one to three years, inertia warnings and the questions you still have to answer.
It closes with six doctrine principles that count as hard rules, the source credits to Wardley's freely available work and the licence: MIT, keeping the source credits to TheSEO and Simon Wardley. More on that doctrine below, because that is where the character of this skill sits.
Pioneers, settlers, town planners
reg. W.003A map without moves is wallpaper. In step five the skill translates the positions on the map into who should work on them and which strategic moves are open. The three-way split comes from Wardley's work: every type of component asks for a different type of team, and it goes wrong in the places where a pioneer sits on commodity work or a town planner on an experiment.
The sources the skill rests on
Wardley Mapping is not a management fashion with a certification programme but an open method. Simon Wardley has published his work online since 2015, freely available under Creative Commons, and the SKILL.md names his three sources: the book about Wardley Maps as topographical intelligence in business, the Medium series "On being lost" in which Wardley describes how he discovered as a CEO that he was navigating without a map, and the doctrine, his collection of forty universal principles for effective organisations from 2018.
That provenance explains the tone of the skill. Wardley did not write his method as a consultancy product but as a correction to his own blind spot: he ran a company, could answer every question about revenue and team, and had no answer to the question why he chose one strategy and not another. That map became his answer, and the doctrine is the distillation of what kept going wrong at companies without one. Six of those principles are carried over as hard rules, which you see in action in the next section.
For completeness: the skill itself is under the MIT licence and is free to use, adapt and distribute, keeping the source credits to TheSEO and Simon Wardley. So you may also use it in your own advisory practice.
Which of the neighbouring skills you reach for next depends on the question. If the map shows that everybody in your terrain is moving the same way, the next question is where nobody is standing yet, and that is the job of the Blue Ocean Strategy Coach. To lay the framework beside other strategy instruments, the SWOT analysis skill and the PESTEL Analyst skill are in the same library: the first for the photograph of your current position, the second for the forces from outside. Of the three, the Wardley Map is the only one that shows movement.
Six rules the skill enforces
reg. W.004This skill has no separate list of refusals like some other skills in the library; its limits sit in the doctrine. The SKILL.md holds six principles under the heading "Always follow these rules", and in practice they work as a filter on everything you supply. In conversation that plays out like this: six things you could say, with the response the skill gives according to its own instructions.
Installing in Claude Code, Claude.ai or Codex
The zip contains one folder with the SKILL.md inside it. Installing is a matter of putting the file in the right place, and that place differs per environment. SKILL.md has been an open standard since December 2025, so the same skill also works in Codex, Cursor and Gemini CLI. You are therefore not downloading a Claude file but a working instruction that any modern AI assistant can read. The full guide per environment is in installing Claude skills.
- Unzip it into
~/.claude/skills/(or.claude/skills/in your project). - Claude then recognises the skill by itself as soon as you ask a strategy question or ask for a map.
- You can also call it directly, with
/ai-wardley-mapping-strategist.
- Go to Customize and then Skills.
- Upload the zip there as a skill.
- Or paste the contents of SKILL.md into the project instructions of a Project.
- Open
AGENTS.mdin your repo. - Paste the contents of SKILL.md into it, or put SKILL.md beside it as a separate file and point to it from
AGENTS.md. - Codex reads that along at every session.
After that, use is simple: describe your business or product and ask for a Wardley Map, or simply ask the question you are stuck on, such as what should I build myself and what should I buy. It asks its own questions per step and carries on until the map satisfies the doctrine. New to this kind of file? Start at the knowledge base for the broader explanation of working with AI.
When you use it and when you do not
This one is at its strongest on strategic choices in which dependencies and evolution play a part. Develop in house or outsource. Buy or build. Choosing a platform strategy. Understanding why a competitor suddenly gives away for free what you sell. Specifically useful, says the file, for business owners making these kinds of decisions while technology or markets shift. That is exactly the moment when a list falls short and a map makes the difference.
There are also situations where you are better off leaving it alone. If you have no idea who your user is or what their primary need is, the skill holds you at step one and no map appears: that is not a failure of the method but the honest signal that a more fundamental question is waiting.
Size matters as well. For an operational decision without dependencies, such as the choice between two comparable tools, a whole map is overkill: there the Two-Way Door Decider skill is the fitter instrument, because it first tests how reversible the decision is. And anyone who wants to analyse the forces from outside, from politics to technology, is better off with the PESTEL Analyst: that one looks at the weather, the Wardley Map at the terrain.
The most important limit sits in the nature of the instrument, and the skill names it itself in its doctrine: the map is always provisional. It is only as good as the information you supply about your components and their stage, and it is an instrument for a conversation, not an oracle.
So the document is not the point. The value is not in the map as a document but in the conversation it forces: why does this component sit there, why do we think this is our moat, and what do we do when it shifts to the right. Make the map once and frame it, and you get little out of it. Update it every quarter and you see shifts coming before they show up in the revenue.
Run it yourself or have it run
reg. W.005This skill is the free do-it-yourself version of analysis work we also deliver as a service. It stays complete and free of catches. Just understand what a skill is: it teaches your AI how to do something, while every new session starts empty. A skill is not the engine, and it is certainly not the memory. You prompt, you supply the context again every time, you check. Want that differently? There are two next steps: hand over the engine, or sort out the memory.
where you are now The skill: you are the engine You run the Wardley Mapping Strategist yourself in Claude, Codex or Cursor. It costs nothing, it works today, and you keep it entirely in your own hands: no trial period, no locked-off parts. The limit is your own time: the map is only updated when you think of it.
only when it comes back The AI employee: usually not the next step here None of our roles fits here, and we would rather say so than sell it to you. The three roles we set up ready-made are the Quote employee (sorting incoming enquiries and preparing draft quotes), the Sales employee (prospect research and outreach drafts) and the Reporting employee (summaries and weekly and monthly reports from your own data). What this skill delivers, a readable map with strategic moves, belongs to none of those three. What is possible is a bespoke role through Mansotti, the company of which TheSEO is the trading name, but only if your map really moves and you want to keep track of that movement. If this work stays a single session a year for you, skip step 2: a map is only an instrument once you can lay the previous version beside it, and that is step 3. What an AI employee does do is on that page.
everything from one source Jarvis: all your AIs work from the same company knowledge A skill teaches the AI something; the brain is where that stays. Want all your AIs working from the same company knowledge? That is Jarvis, the organisation brain. It connects ChatGPT, Claude, Codex and your people to the same projects, core knowledge and decisions, so your next AI session does not start over. For this skill that means: your map, your stage estimates and the decisions that followed from them are simply still there next time, in every AI tool you use. What that delivers in practice, from the plans to your first week, you can read at Jarvis itself.
What Jarvis actually delivers
reg. W.006Step 3 deserves more than a paragraph, because with mapping in particular memory is the difference between a nice experiment and an instrument. A Wardley Map is only worth something if it is kept up, and that is only possible if your AI still knows what was on it last time. Jarvis is the organisation brain that arranges that: it remembers what your AIs need to know, divides the work and keeps track of what happened. This is what that looks like at the moment you notice it: the start of a new session.
We have been running on this system ourselves for months. Every agent session, every task and every decision is logged in it and can be read back. A new session therefore does not start blank: it first fetches the recorded decisions, the running projects and the latest changes, and carries on where the last one stopped. So we are not describing a promise but the way we work every day.
All plans are at jarvis/pricing. You pick your own plan. Paying online opens as soon as the last checks are done; until then we set your account up on request. For business agreements and bespoke work there is a conversation.
The skills around it
reg. W.007A Wardley Map rarely stands alone: it shows the terrain, but you also want the photograph of your current position, the weather report from outside and a method for making the decision itself. These skills from the same library of 100 each take a different piece.
The other lenses
position and surroundingsA Wardley Map shows the terrain and the movement. These three show what it deliberately leaves out.
SWOT analysisThe photograph of your current position: strengths and weaknesses beside opportunities and threats, as a starting point for the map.SKILL PESTEL AnalystThe forces from outside, from politics to technology: the weather report to go with the terrain of the map.SKILL Blue Ocean Strategy CoachAsks the question the map does not: which piece of terrain nobody is fighting over yet.SKILLAfter the map
the decisionA map sets out the options. At some point after that a knot has to be cut.
Two-Way Door DeciderFirst tests how reversible the decision is, and with that decides how much analysis it deserves. The timing instrument beside the map.SKILL BCG Matrix StrategistDivides your portfolio into stars, cash cows and question marks: a second evolutionary view, but at product level.SKILLLearning to work with skills
the foundationNew to skills, or do you want to build one yourself? Start with these three.
What Claude skills areThe complete story: what a skill is, how it works and why it became an open standard.BLOG installing Claude skillsThe installation guide for every environment, step by step.BLOG writing a SKILL.mdBuilding a skill yourself according to the open standard, from frontmatter to doctrine.BLOGLooking further
the contextWhere this skill comes from and what else there is.
The whole skill libraryAll 100 free skills in a row, sorted by subject.HUB AI and automationThe service behind it: from separate skills to working automation in your business.SRV AI trainingIf your team wants to learn to set up this kind of work themselves.SRV Knowledge baseArticles about SEO, AI and online visibility, searchable.DOCFrequently asked questions
What does the Wardley Mapping Strategist skill cost?
Nothing. The skill is free, falls under the MIT licence, and you do not have to create an account or leave an email address. You download a 5.2 KB zip containing one folder and a single file, SKILL.md, and that is the complete skill. The licence only asks that the source credits to TheSEO and Simon Wardley are kept. There is no paid version and no sales email follows.
Does this skill work in Codex, Cursor or Gemini CLI?
Yes. SKILL.md has been an open standard since December 2025, so the same file works in Codex, Cursor, Gemini CLI and other tools that follow the standard. In Codex you unzip it into .agents/skills/ in your project, or into ~/.agents/skills/ for all your projects; Codex has supported SKILL.md directly since the open standard of December 2025. Pasting the contents of SKILL.md into your AGENTS.md still works too. The instructions are plain readable text, so any assistant that accepts instruction files can handle it.
What exactly is a Wardley Map?
A strategic map with two axes. The vertical axis is the value chain: at the top sits the need of the user, below it everything needed to deliver that need, down to the invisible infrastructure. The horizontal axis is evolution: every component moves from Genesis through Custom Built and Product to Commodity. Because you see dependencies and movement in one picture, questions such as build or buy suddenly become answerable.
How many components should my map have?
The skill does not stop before at least eight components are on the table, because an empty map says nothing. The upper limit is in the file as well: a good map has eight to fifteen components, more makes it unreadable. If you go above that, it is a sign that you should merge components or make a second map for another part of your business.
Does the skill draw the map visually too?
The skill delivers the map in text or ASCII, plus a components table with the visibility, the evolutionary stage and a note per component. That is deliberate: a text representation can be pasted into any conversation, version controlled and updated. The map above on this page is a schematic example of what such a map looks like when you draw it out.
What do Pioneer, Settler and Town Planner mean?
It is Wardley's answer to the question of who should work on which component. Components in Genesis call for Pioneers: experimental teams who explore the unknown. Components in Custom and Product call for Settlers, who turn them into a solid product. Components heading for Commodity call for Town Planners, who steer on efficiency and scale. The skill uses that three-way split in step five to indicate which type of attention each component needs.
May I use the skill commercially, for instance with clients?
Yes. The skill is under the MIT licence: free to use, adapt and distribute, keeping the source credits to TheSEO and Simon Wardley. The underlying work of Wardley himself is freely available online under Creative Commons. So you can simply use the skill in your own advisory practice or prepare your internal strategy sessions with it.
First the terrain, then the route
A good map almost always shows the same thing: your visibility in search engines and AI answers is a component your revenue leans on, and it is shifting along the evolution axis. If you want to know where that component sits today for your site, the free SEO scan shows it in a few seconds. In the guide which strategy model when you can see how this model relates to the others. And if you want to talk further about what AI can do for your business, from separate skills to full automation, we simply do that in a conversation.