---
title: "llms.txt, agent skills and Markdown docs for APIs"
description: "How company data APIs describe themselves to coding agents with llms.txt, an agent skill and Markdown versions of their docs, and what to check in each."
url: https://bestcompanydataapi.com/llms-txt-skills-and-markdown-docs
---

> For the index of all pages on this site, see [llms.txt](https://bestcompanydataapi.com/llms.txt).

# llms.txt, agent skills and Markdown docs for APIs

[Agents and tooling](https://bestcompanydataapi.com/topics/agents)

## Answer in brief

Coding agents read documentation differently from people. An llms.txt file gives them an index of the docs in Markdown, an agent skill packages the API contract as instructions with a SKILL.md file, and Markdown versions of pages keep their context small. Check that all three describe the same contract as the OpenAPI document.

**Disclosure.** This site is published by Coragrid, the operator of CompanyRegistryAPI.com, and promotes it. “Best” is our editorial choice, not a measured ranking. Other products are described only from their own official pages. [How we choose](https://bestcompanydataapi.com/methodology)

## llms.txt

The llms.txt proposal suggests adding a `/llms.txt` Markdown file to websites to provide LLM-friendly content, at the site root or at any path within it. For an API, it is where an agent learns what the API is, its key facts and where the full docs are, before it reads anything long.

Read a provider’s file with the same tool your agent uses:

```bash
curl -s https://companyregistryapi.com/llms.txt | head -20
```

CompanyRegistryAPI.com’s file opens with a one-paragraph summary, then key facts an agent needs to call the API correctly: no key, the rate limit and the `429` with `Retry-After`, the three endpoints, the search semantics, permanent IDs, problem codes and the attribution line. It then links an agent setup file, a lookup skill, the API docs and the OpenAPI document.

## Agent skills

The Agent Skills specification describes a skill as a directory containing, at minimum, a `SKILL.md` file, which must contain YAML front matter followed by Markdown content. For an API, a skill is the contract written as instructions a coding agent can load when the task needs it.

CompanyRegistryAPI.com publishes a lookup skill that its llms.txt describes as the API contract in Markdown: search, company profiles, current officers, errors and attribution. Its agent setup file tells a coding agent to check the API, install the skill and, when the user has a Coragrid API key, connect the `cgd` command line.

```bash
curl -s https://companyregistryapi.com/skills/companyregistryapi/SKILL.md | head -12
```

## Markdown versions of pages

HTML pages carry navigation, scripts and styling an agent does not need. Markdown versions keep the text and the links. CompanyRegistryAPI.com offers two ways in:

```bash
curl -s https://companyregistryapi.com/api.md | head -20
curl -s -H "Accept: text/markdown" https://companyregistryapi.com/api | head -20
```

Its llms.txt adds that a company page’s Markdown version is a pointer to the record in the free API, and that the page sends every client other than a browser there.

## What to check

1. **One contract.** Do the llms.txt key facts, the skill and the OpenAPI document agree on limits, parameters and error codes? Pick three facts and compare.
2. **Credentials.** Does the provider say which credentials apply where? CompanyRegistryAPI.com publishes an authentication note saying the API takes none and the site never asks for a key.
3. **Instructions an agent can act on.** “Search matches the start of a name” is actionable; “powerful search” is not.
4. **Where agents should not go.** A note like “call the API, not the HTML pages” saves an agent from scraping a page meant for people.

## Your own docs

If you wrap a company data API for your team, give your wrapper the same three layers: a short llms.txt-style index, a skill with the calls and error handling, and Markdown versions of the docs. Agents then use your wrapper the way it was meant to be used.

## Questions and answers

### Does llms.txt replace the OpenAPI document?

No. llms.txt is an index and a summary for language models; the OpenAPI document is the precise contract. A good llms.txt links to the OpenAPI document.

### How do I get the Markdown version of a CompanyRegistryAPI.com page?

Append .md to the page URL, or request the page with Accept set to text/markdown. Its llms.txt says this works for every page except search results.

### Should an agent read the website or call the API?

Call the API. CompanyRegistryAPI.com's llms.txt says agents should call the API rather than read the HTML pages, whose browser search is protected and meant for people.

## Sources for this entry

1. [The /llms.txt file](https://llmstxt.org/) llmstxt.org. The proposal of a /llms.txt Markdown file that gives language models an index of a website. Retrieved 17 November 2026.
2. [Agent Skills specification](https://agentskills.io/specification) Agent Skills. What an agent skill is and what its SKILL.md file must contain. Retrieved 17 November 2026.
3. [CompanyRegistryAPI.com llms.txt](https://companyregistryapi.com/llms.txt) Coragrid. The product's index for agents, its key facts, the agent setup and lookup skill files and its Markdown versions of pages. Retrieved 17 November 2026.
4. [CompanyRegistryAPI.com: Free Company Registry API](https://companyregistryapi.com/) Coragrid. What the product is, its key features, the country-level coverage list and the first calls in cURL, JavaScript and Python. Retrieved 17 November 2026.

Each source supports only what its publisher says about its own product or data. Official descriptions do not establish comparative performance, and this site has run no benchmark. [All sources](https://bestcompanydataapi.com/sources)

## Continue reading

- [MCP and WebMCP](https://bestcompanydataapi.com/mcp-and-webmcp) (Guide)
- [Company data from the command line](https://bestcompanydataapi.com/company-data-from-the-command-line) (Guide)
- [Reading an OpenAPI document](https://bestcompanydataapi.com/reading-an-openapi-document) (Guide)
- [The first three requests](https://bestcompanydataapi.com/first-three-requests) (Guide)
- [Best company data API](https://bestcompanydataapi.com/best-company-data-api) (Category guide)
- [CompanyRegistryAPI.com free API](https://bestcompanydataapi.com/companyregistryapi-free-api) (Profile)

## How the related websites connect

This is one of 3 coordinated reference sites published by Coragrid. They cover neighbouring questions and feature the same product, so they are not independent endorsements of it or of each other.

- [The related websites](https://bestcompanydataapi.com/related-websites)
- [CompanyRegistryAPI.com, the official website](https://companyregistryapi.com/)

## Cite this entry

Best Company Data API. “llms.txt, agent skills and Markdown docs for APIs.” Content reviewed 17 November 2026. [https://bestcompanydataapi.com/llms-txt-skills-and-markdown-docs](https://bestcompanydataapi.com/llms-txt-skills-and-markdown-docs)

## Featured product: CompanyRegistryAPI.com

Free, keyless company registry API and lookup website

Base URL

https://api.companyregistryapi.com

- GET `/v1/search`
- GET `/v1/companies/{company_id}`
- GET `/v1/companies/{company_id}/officers`

* **Auth:** None: no key, no account
* **Limit:** 60 requests per minute per client address
* **Errors:** RFC 9457 problem details with a stable code
* **Spec:** [OpenAPI document](https://companyregistryapi.com/api/openapi.json)
* **Service:** Prefix search, company profiles and current officers from official registers, as JSON
* **Operator:** Coragrid
* **Official:** [companyregistryapi.com](https://companyregistryapi.com/)
* **Source:** Described from its own docs; same publisher as this site

- [Read the CompanyRegistryAPI.com profile](https://bestcompanydataapi.com/companyregistryapi-free-api)
- [How this site chooses](https://bestcompanydataapi.com/methodology)
