Skip to content
blankcollar/me
Claim handle
spec · v1 · electric accent

The human.md standard.

A markdown file that describes a professional human in a way both humans and AI agents can read. Free for anyone to implement. MIT licensed. Stewarded by Blank Collar.

what this is

A human.md file is a markdown file that describes a professional human in a way both humans and AI agents can read. It replaces the static CV, the LinkedIn profile, and the cold outreach inbox with a single living artifact the person controls.

The file is plain markdown. The schema is permissive but the parser is strict. Required sections must be present. Optional sections are skipped if empty.

validate your file
Paste your human.md, see if it passes.
valid · passes the V1 schema
parsed JSON
{
  "specVersion": "v1",
  "identity": {
    "name": "Lukas Müller",
    "handle": "lukas",
    "pronouns": "he/him",
    "locations": [
      "Zürich",
      "Switzerland"
    ],
    "languages": [
      "Swiss German (native)",
      "German (fluent)",
      "English (fluent)",
      "French (working)"
    ],
    "timezone": "Europe/Zurich",
    "workAuthorization": "Swiss, EU"
  },
  "current": "Founder, Blank Collar. Stewarding the open standard for human-readable, agent-readable professional files. The protocol you are reading.\n\nIndependent operator. Building tools that put the rules of the next decade of work into the hands of the people who do the work, not the platforms that broker it.",
  "availableFor": [
    {
      "kind": "ask",
      "state": "open",
      "description": "Anything about the open standard, MCP tooling, agent-readable identity, the future of work in Europe."
    },
    {
      "kind": "advisory",
      "state": "selectively",
      "description": "Founders and design partners shipping agent-native surfaces."
    },
    {
      "kind": "speaking",
      "state": "open",
      "description": "The standard, agent-readable identity, the second renaissance of work."
    },
    {
      "kind": "partnership",
      "state": "open",
      "description": "ATS, HRIS, identity, and standards bodies."
    }
  ],
  "contact": {
    "email": "lukas@blankcollar.me",
    "protocol": "https://lukas.blankcollar.me/mcp",
    "preferred": "agents call request_intro first, humans use email"
  },
  "philosophy": "Work is for bots. Life is for humans.\n\nMost people are about to lose the kind of work that does not need them anymore. The answer is not nostalgia. It is the layer where humans direct, decide, and create meaning while agents execute. The file is the smallest piece of that layer that anyone can own today.",
  "howIWork": "Fast on architecture, slow on hiring. Async first, deep work in long blocks. I write before I meet. I prefer one one hour conversation to four scheduled standups. I read decks in three minutes and judge them on whether they respect my time.\n\nSuspicious of consensus, especially when consensus pays. The standard belongs to no one and that is the point.",
  "proof": [
    {
      "text": "Steward, the human.md open standard",
      "url": "blankcollar.me"
    },
    {
      "text": "Two decades across digital, design, and platform work in Zürich and the EU."
    },
    {
      "text": "Speaker, agentic identity and the future of work, multiple European stages."
    },
    {
      "text": "Maintainer",
      "url": "github.com/blankcollar."
    }
  ],
  "frameworks": [
    "The standard is the gate. Anything we charge for is a layer on top of an open standard, never a replacement.",
    "Files over forms. Markdown over JSON over PDF. Every step toward something a human and an agent can both read."
  ],
  "writing": [
    "blankcollar.me/notes",
    "github.com/blankcollar"
  ],
  "refusing": [
    "cold pitch decks for generic AI startups",
    "speaking on AI hype panels with no point of view",
    "crypto projects with token economics",
    "closed-source extractions of the open standard"
  ],
  "meta": {
    "spec": "https://github.com/blankcollar/human-md/v1",
    "updated": "2026-05-07",
    "canonical": "https://lukas.blankcollar.me/human.md"
  }
}

file location

The canonical location is one of:

  • https://{handle}.blankcollar.me/human.md
  • https://{your-domain}/human.md
  • https://github.com/{user}/{user}/blob/main/human.md

structure

Three layers. Required core, optional self authored, verifiable. Plus a meta footer with spec version, last updated, canonical URL.

layer 01 · required core

Every file must contain these four sections. Parsers reject the file as invalid if any are missing.

## identity

Basic facts about the person. No prose, key value pairs. name, handle, locations, languages, timezone, work_authorization.

## current

What the person is doing right now, in one paragraph or in structured roles.

## available for

What kinds of engagement are open. Each entry has a state: open, selectively, closed, rare, protocol_only.

## contact

How to reach the person. The protocol field tells agents what to call.

layer 02 · optional self authored

The person fills in what is true for them. Empty sections are skipped, never faked.

## philosophy

How the person thinks about work, the world, their field.

## how I work

Working style, async vs sync, how decisions get made.

## proof

Public, verifiable evidence, every entry links to something auditable.

## frameworks

Original intellectual contributions: things this person built that others use or cite.

## writing

Where the person publishes long form.

## refusing

What this person will not do. Saves both sides time.

layer 03 · verifiable (V2)

Sections like ## employment (verified) and ## education (verified) are populated by signed JSON-LD blocks issued by employers, schools, and certifying bodies using W3C Verifiable Credentials. V1 files can omit these. The reference implementation supports them in V2.

MCP protocol contract

Every human.md should be paired with an MCP server that exposes these tools to agents:

get_profile()

Returns the full file content.

get_current_focus()

Returns just the current section.

ask(question)

Runs Claude grounded in the file, in the person's voice.

check_availability(kind)

Returns the state for a given engagement type.

request_intro(context, name, email)

Queues outreach for human review.

get_proof(domain)

Returns proof links for a given domain.

get_credentials()

Returns Verifiable Credentials, signed JSON-LD. V2.

license · governance

The spec is published under MIT. Reference implementations are MIT. Anyone can implement, host, and extend. The standard is stewarded by Blank Collar. Major changes go through an open RFC process.

Spec on GitHub →ParserMCP server