humans.txt — how to make your site agent-ready

What it is

humanstxt.org proposes a plain-text file listing the team, thanks, and site technology. Not an agent standard per se — but a nice signal of a site that cares about craft, and the exact kind of metadata an agent can quote back to a human asking "who made this?".

Remediation Prompt

I want to improve my site's agent readiness. Please implement the following fix for humans.txt across our codebase.

Instructions:
Please fix the humans.txt issue on my site so it is agent-ready.

How we test it

Step	Method	URL
A	GET	`/humans.txt`

Pass Warn Fail Matrix

Condition	Status	Score
Exists, non-empty text, plausible structure	pass	1.0
Exists but empty	warn	0.3
404	not_applicable	—

Remediation Prompt

Optional: publish /humans.txt. Example:

    /* TEAM */
      Creator: Jane Doe
      Contact: jane [at] example.com
      From: Istanbul, TR

    /* THANKS */
      Friend: John Smith

    /* SITE */
      Last update: 2026-04-20
      Language: English / Turkish
      Technology: Next.js, Tailwind, SQLite

Keep it plain, ASCII-safe, under 8KB. Serve as text/plain.

References

humanstxt.org

Test Fixtures

pass.txt
warn-empty.txt
na-404.json