# skurekjakub.dev

> Notes and writing by Jakub Skurek. Every page listed below is also served
> as plain markdown: append `.md` to its URL, or follow the links below.

**How to read this site**

Every page listed below is served as Markdown, at a fraction of the tokens
of its HTML. Requests whose `User-Agent` names a known agent get it
automatically; any client can ask for it explicitly:

- Append `.md` to the page URL.
- Send `Accept: text/markdown` to the page URL. The HTML also advertises its
  twin through a `Link: <…>; rel="alternate"; type="text/markdown"` header
  and a matching `<link>` tag.

To read the HTML instead, send `Accept: text/markdown;q=0`, which overrides
the `User-Agent` match. Links inside a twin already point at `.md`, so
following them keeps you in Markdown.

Take page paths from this index rather than constructing them — guessed
paths 404. https://skurekjakub.dev/skill.md summarises all of this for agents.

## Author

- [About Jakub](https://skurekjakub.dev/about.md)

## Posts

- [Routing agentic traffic](https://skurekjakub.dev/blog/audience-aware-routing.md): Route incoming requests between HTML and markdown based on context.
- [Serving markdown content](https://skurekjakub.dev/blog/serving-markdown-content.md): Serve content for multiple audiences in different formats from a single, shared source.
- [Automating release notes](https://skurekjakub.dev/blog/changelog-automation.md): Skills, prompting strategies, and headless workflows to automate product release notes.
- [Customizing the Claude Code statusline](https://skurekjakub.dev/blog/cc-statusline.md): Did you know Claude Code has a customizable status bar similar to Oh-My-Posh? I didn't until Anthropic chose to remove context tracking from the default interface. And I'm glad they did, because the alternative is pretty neat.
- [Measuring AI accessibility with afdocs](https://skurekjakub.dev/blog/agentic-accessibility-afdocs.md): A look at the agent-friendly docs spec - https://agentdocsspec.com/ - and how it can help us judge just how accessible a site is to agents.

## Optional

- [Whole site as one file](https://skurekjakub.dev/llms-full.txt): every page above, concatenated.