agentleFS
frontmost-aifrontmost-ai/aeo-skills/skills/source-map/SKILL.md

source-map

Skill1 starsChanged 3 days agoMITView on GitHub

Find the pages that shape AI answers to a business''s buyer questions, sort them by type, check whether each page lists the business, and say how a business gets onto each one. Covers list articles, review sites, directories, forums, and videos. Use for "which sites does ChatGPT cite for my category", "where should we be listed", or before outreach. Works with a web search. Needs no Frontmost AI account.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 7 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this guidance to make the list of those pages for one business, and to say what to do about each page.

    line 12
  2. Very specific:

    Use five to ten discovery questions: buyer questions that do not contain the business name.

    line 16
  3. Distinctive:

    Use the best source that you have.

    line 22
  4. Distinctive:

    Check who publishes each list before you set its type.

    line 45
  5. Distinctive:

    Do not edit an encyclopedia article about the person's own business.

    line 47
  6. Distinctive:

    Only Not present supports a pitch.

    line 62
  7. Distinctive:

    Never guess a contact address.

    line 78
  8. Distinctive:

    Do not promise that a listing earns a mention.

    line 91

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Source map

An AI app builds an answer from a few pages: list articles, review sites, directories, forums, and videos. A business that those pages leave out is easy for the AI app to leave out too.

Two examples that Frontmost AI published: one review site was in 16 of 30 answers to mattress questions (e-commerce). The most cited sites for one software category differ between the United States and Germany (product strategy).

Use this guidance to make the list of those pages for one business, and to say what to do about each page. This skill contacts nobody.

1. Get the questions

Use five to ten discovery questions: buyer questions that do not contain the business name. Take them from the person, or write them with the question-drafting skill.

Get the market too: the country, the language, and the city for a local business. Make one map for each market. The pages differ by market.

2. Collect the pages

Use the best source that you have. Say which one you used.

SourceWhat it givesLimit
A Frontmost AI projectThe pages that AI answers cite, with counts. Use the placement-tracker skill in place of this oneNeeds an account
A mention-check countThe pages that the answers linked, in the Linked Pages columnA small sample
A web searchThe first ten results for each questionThese pages stand in for AI citations. You have no citation counts

For each page, count the questions, or the answers, where it appears. Join two addresses of one article into one row.

3. Sort the pages by type

TypeExamplesHow a business gets on itSkill
Editorial list or reviewA "best X" article, a test by a review sitePitch the author or the editorlisticle-outreach
Directory or marketplaceA software directory, a trade directory, an app marketplaceClaim or create the listing, and complete itdirectory-listings
Business profileGoogle Business Profile, Bing PlacesClaim it, verify it, and keep its facts currentdirectory-listings
CommunityA Reddit thread, a forum, a question siteA useful reply that states the writer's real rolecommunity-replies
VideoA review or a comparison on YouTubePitch the creator, as you pitch an editorlisticle-outreach
Rival or vendor siteA list on a rival's blogNot reachable. Never ask. Learn from its formatpage-drafting
ReferenceAn encyclopedia, a government page, newsUsually not reachable by requestnone
Own siteA page of the businessImprove the pagesite-audit, page-drafting

Check who publishes each list before you set its type. A list where the publisher ranks its own product is a rival or vendor site.

Do not edit an encyclopedia article about the person's own business. Wikipedia's conflict-of-interest rules discourage it.

4. Check each page

Open the pages with the highest counts, up to 15. When most pages have a count of 1, the count does not order them. Then open the editorial lists and the directories first.

Give each page one result:

ResultRule
PresentThe page shows the full name of the business, or links the business's own domain
Not presentYou read the complete page, and it has no name and no link of the business
Check neededThe page did not load, loaded in part, or holds fewer than 400 characters of article text. Or only a short name appears, and it can be another business
Not openedYou did not open the page in this run
  • Only Not present supports a pitch. Check needed means that a person opens the page first. Not opened means that nobody read the page.
  • A link to a shared site, such as a Reddit, LinkedIn, or YouTube address, does not identify a business.
  • Record the rivals that each page lists.
  • Some sites refuse automated requests. List those pages for the person to open in a browser.

5. Write the entry for each site

For each page with the result Not present, record four facts. Take them only from pages of that site that you opened.

FactValue
How to get on itOne sentence with the real mechanism of this site: claim a listing, apply, pitch the editor, earn reviews, or take part
What decides the orderA short phrase, or "not clear"
CostFree, paid, or unknown
Where to startThe address on that site where a business starts: a sign-up page, a "list your business" page, or the editor's published contact. Or "none found"

Never guess a contact address. Never suggest fake reviews, paid links, or keywords added to a business name.

6. Save the map

Save a spreadsheet file, source-map-<date>.csv, with one row for each page:

Page, Site, Type, Count, Business (Present, Not present, Check needed, or Not opened), Rivals On Page, How To Get On It, What Decides The Order, Cost, Where To Start, Next Skill.

Sort the rows by Count. Put Check needed rows after the others, and Not opened rows last.

Rules

  • Give each count with its source: answers, or web-search results.
  • Do not promise that a listing earns a mention. A page on the map is a bet that the data supports.
  • Contact nobody from this skill. Outreach has its own approval rules in the listicle-outreach skill.
  • Refresh the map each quarter, or after a new mention-check.

Output

  1. The source that you used, the market, and the date.
  2. The spreadsheet file. If you cannot make a file, return the table as CSV.
  3. The three pages to work on first, each with its type, its count, and its skill.
  4. The pages that need a check by the person, and the number of pages that you did not open.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.