# mical.pl

> Personal website and developer tools from Mateusz Micał. No authentication required.

mical.pl is the personal website for Mateusz Micał, a software developer focused on PHP, Laravel, Vue.js, backend development, and Linux administration. The site is public and read-only.

## Agent entry points

- `/llms.txt` — This file
- `/llms-full.txt` — Full concatenated site text for RAG pipelines and non-browsing agents
- `/skill.md` — Agent skill definition (agentskills.io spec)
- `/openapi.json` — Machine-readable OpenAPI spec for all endpoints
- `/skills.json` — Curated action list for agents
- `/agents.txt` — Agent access policy
- `/.well-known/claude.json` — Claude service discovery manifest
- `/.well-known/ai-plugin.json` — AI plugin discovery manifest
- `/health` — JSON health check
- `/sitemap.xml` — XML sitemap

## Site pages

All content pages exist in both Polish and English:

| Polish | English | Description |
|--------|---------|-------------|
| `/` | `/en` | Homepage |
| `/o-mnie` | `/en/about` | Professional background and skills |
| `/kontakt` | `/en/contact` | Contact details and profile links |

The homepage supports content negotiation: `Accept: application/json` returns a structured site summary, `Accept: text/plain` returns a plain-text summary.

## Developer tools (JSON API)

Tool endpoints return computed JSON when `/json` is appended to the tool URL. No special headers required. Polish paths use `/narzedzia/<slug>/json`, English paths use `/en/tools/<slug>/json`. Omit all parameters to receive a usage description.

| Tool | English path | Required params |
|------|-------------|-----------------|
| Base64 encode/decode | `/en/tools/base64/json` | `input`, `mode` (encode\|decode) |
| URL encode/decode | `/en/tools/url-encoder/json` | `input`, `mode` (encode\|decode) |
| Hash generator | `/en/tools/hash-generator/json` | `input` |
| Color converter | `/en/tools/color-converter/json` | `color` (#hex, rgb(), hsl()) |
| Unix timestamp | `/en/tools/unix-timestamp/json` | `timestamp` or `date` (optional — omit for current time) |
| Password generator | `/en/tools/password-generator/json` | none (options: `length`, `uppercase`, `lowercase`, `numbers`, `symbols`, `ambiguous`) |
| Regex tester | `/en/tools/regex-tester/json` | `pattern`, `input`, `flags` (optional) |
| Text diff | `/en/tools/text-diff/json` | `original`, `modified` (GET) or JSON body (POST) |
| IP info | `/en/tools/ip-info/json` | none |

## Examples

- `curl "https://mical.pl/en/tools/base64/json?input=hello&mode=encode"` — encode "hello" to Base64
- `curl "https://mical.pl/en/tools/hash-generator/json?input=hello"` — MD5 + SHA hashes of "hello"
- `curl "https://mical.pl/en/tools/color-converter/json?color=%23ff5733"` — convert #ff5733 to RGB and HSL
- `curl "https://mical.pl/en/tools/unix-timestamp/json"` — current Unix timestamp
- `curl "https://mical.pl/en/tools/password-generator/json?length=20"` — generate a 20-character password
- `curl "https://mical.pl/en/tools/regex-tester/json?pattern=%5Cd%2B&flags=g&input=abc123def456"` — find all digit sequences
- `curl "https://mical.pl/en/tools/ip-info/json"` — caller's IP and geolocation
- `curl -X POST -H "Content-Type: application/json" -d '{"original":"a\nb","modified":"a\nc"}' https://mical.pl/en/tools/text-diff/json` — diff two texts