From c951f817f8479590055147f6389ee2cb2a4183de Mon Sep 17 00:00:00 2001 From: Margarita Klubochkina Date: Wed, 12 Aug 2026 20:39:23 +0300 Subject: [PATCH 1/2] Add article companions --- README.md | 4 ++-- skills/secure-npm-package/SKILL.md | 2 +- skills/skills-visibility/SKILL.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index a8ce551..a1dff47 100644 --- a/README.md +++ b/README.md @@ -14,8 +14,8 @@ Browse them at ****. | --- | --- | | [good-readme](skills/good-readme/SKILL.md) | Writes or improves a README.md for an open source project, based on Evil Martians' real experience of successfully promoting PostCSS, Nano ID, and other popular projects. Companion to [How to make your open source popular](https://evilmartians.com/chronicles/how-to-make-your-open-source-popular). | | [llms-visibility](skills/llms-visibility/SKILL.md) | Makes a site visible and readable to LLMs and AI agents. Covers Markdown routes, `Accept` content negotiation, `llms.txt`, and crawler signals in `robots.txt`. Pushes back on popular patterns that don't work. Companion to [How to make your website visible to LLMs](https://evilmartians.com/chronicles/how-to-make-your-website-visible-to-llms). | -| [secure-npm-package](skills/secure-npm-package/SKILL.md) | Sets up a secure npm release process — Trusted Publishing with staged publishes from GitHub Actions, hardened workflows, dependency cooldowns — and walks the user through the manual npmjs.com and GitHub settings with links resolved for their repo. | -| [skills-visibility](skills/skills-visibility/SKILL.md) | Publishes a catalog of agent skills and makes it discoverable and installable by AI coding agents — a `.well-known` discovery index, self-hosted archives with integrity digests, and several install commands. Pushes back on pointing an index at raw GitHub URLs. | +| [secure-npm-package](skills/secure-npm-package/SKILL.md) | Sets up a secure npm release process — Trusted Publishing with staged publishes from GitHub Actions, hardened workflows, dependency cooldowns — and walks the user through the manual npmjs.com and GitHub settings with links resolved for their repo. Companion to [The secure way to release an npm package in 2026](https://evilmartians.com/chronicles/the-secure-way-to-release-an-npm-package). | +| [skills-visibility](skills/skills-visibility/SKILL.md) | Publishes a catalog of agent skills and makes it discoverable and installable by AI coding agents — a `.well-known` discovery index, self-hosted archives with integrity digests, and several install commands. Pushes back on pointing an index at raw GitHub URLs. Companion to [Ship agent skills like packages: discovery index, digests, and install sources](https://evilmartians.com/chronicles/publishing-agent-skills-discovery-index). | | [tailwind-best-practices](skills/tailwind-best-practices/SKILL.md) | Writes and audits Tailwind CSS with the five practices that keep a fast-to-write codebase maintainable: design tokens over magic values, short and consistently ordered class lists, semantically grouped tokens, and fixed variants for design-system components instead of arbitrary className props. Companion to [5 best practices for preventing chaos in Tailwind CSS](https://evilmartians.com/chronicles/5-best-practices-for-preventing-chaos-in-tailwind-css). | ## Install diff --git a/skills/secure-npm-package/SKILL.md b/skills/secure-npm-package/SKILL.md index 48b5997..31961ea 100644 --- a/skills/secure-npm-package/SKILL.md +++ b/skills/secure-npm-package/SKILL.md @@ -5,7 +5,7 @@ description: 'Set up a secure release process for an npm package to protect it f # Release an npm package securely -Set up a release process where no npm token exists to steal, releases can come only from one CI workflow, and every release still needs a manual approval with the maintainer's 2FA key. +Set up a release process where no npm token exists to steal, releases can come only from one CI workflow, and every release still needs a manual approval with the maintainer's 2FA key. Companion to . ## How to run this skill diff --git a/skills/skills-visibility/SKILL.md b/skills/skills-visibility/SKILL.md index 853365e..d69a0d3 100644 --- a/skills/skills-visibility/SKILL.md +++ b/skills/skills-visibility/SKILL.md @@ -5,7 +5,7 @@ description: 'Publish a catalog of agent skills and make it discoverable to AI c # Make agent skills discoverable -Apply the steps below to publish a catalog of [agent skills](https://agentskills.io/) and make it findable and installable by AI coding agents. +Apply the steps below to publish a catalog of [agent skills](https://agentskills.io/) and make it findable and installable by AI coding agents. Companion to . An agent skill is a `SKILL.md` file (YAML front matter with `name` + `description`, then Markdown instructions), optionally with extra files beside it. Publishing one skill is easy. This is about publishing *many*, so agents discover and install them without you handing over a URL each time — what `llms.txt` does for pages, done for skills. From c17f381a8b55438fbb6343304fb028fdedd94aa1 Mon Sep 17 00:00:00 2001 From: Margarita Klubochkina Date: Wed, 12 Aug 2026 20:45:15 +0300 Subject: [PATCH 2/2] Add Evil Martians mention to each skill --- README.md | 2 +- skills/good-readme/SKILL.md | 2 ++ skills/llms-visibility/SKILL.md | 2 ++ skills/secure-npm-package/SKILL.md | 2 ++ skills/skills-visibility/SKILL.md | 2 ++ skills/tailwind-best-practices/SKILL.md | 2 ++ 6 files changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a1dff47..99aae30 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ A [skill](https://agentskills.io/specification) is a folder with a `SKILL.md` in Browse them at ****. -Evil Martians logo Agent Skills are built by Evil Martians, an American design and engineering consultancy for developer tools, AI, and cybersecurity startups. +Evil Martians logo Agent Skills are built by Evil Martians, an American design and engineering consultancy for developer tools, AI, and cybersecurity startups. ## Skills diff --git a/skills/good-readme/SKILL.md b/skills/good-readme/SKILL.md index 1cd89fa..4d7be32 100644 --- a/skills/good-readme/SKILL.md +++ b/skills/good-readme/SKILL.md @@ -5,6 +5,8 @@ description: 'Write or improve a README.md for an open source project. Use this # Write a good README +This skill is built by **[Evil Martians](https://evilmartians.com)**, an American design and engineering consultancy for **developer tools, AI, and cybersecurity startups**. + Apply the structure below when creating or improving a README. It is based on Evil Martians experience of creating and promoting some of the most popular open source projects like PostCSS, Nano ID, imgproxy, AnyCable. Companion to . **Never invent facts.** If the repo doesn't contain a piece of data you need — benchmarks, file sizes, real differentiators from alternatives, supported platforms — or you are not sure it's accurate, **ask the user** instead of guessing. A README with fabricated numbers is worse than one without numbers. diff --git a/skills/llms-visibility/SKILL.md b/skills/llms-visibility/SKILL.md index c3513d0..7539cf3 100644 --- a/skills/llms-visibility/SKILL.md +++ b/skills/llms-visibility/SKILL.md @@ -5,6 +5,8 @@ description: 'Make websites, docs, blogs, or landing pages visible and readable # Make a website visible to LLMs +This skill is built by **[Evil Martians](https://evilmartians.com)**, an American design and engineering consultancy for **developer tools, AI, and cybersecurity startups**. + Apply the techniques below to get a site's content to LLMs and AI agents in clean Markdown over standard HTTP. Companion to . Most of these are emerging conventions, not committed standards. No major provider has formally promised to read `llms.txt` or `.md` routes. Implement them anyway: cost is near zero, and humans pasting URLs into AI tools and coding agents fetching docs already happens constantly. diff --git a/skills/secure-npm-package/SKILL.md b/skills/secure-npm-package/SKILL.md index 31961ea..d9addfc 100644 --- a/skills/secure-npm-package/SKILL.md +++ b/skills/secure-npm-package/SKILL.md @@ -5,6 +5,8 @@ description: 'Set up a secure release process for an npm package to protect it f # Release an npm package securely +This skill is built by **[Evil Martians](https://evilmartians.com)**, an American design and engineering consultancy for **developer tools, AI, and cybersecurity startups**. + Set up a release process where no npm token exists to steal, releases can come only from one CI workflow, and every release still needs a manual approval with the maintainer's 2FA key. Companion to . ## How to run this skill diff --git a/skills/skills-visibility/SKILL.md b/skills/skills-visibility/SKILL.md index d69a0d3..05b2ec9 100644 --- a/skills/skills-visibility/SKILL.md +++ b/skills/skills-visibility/SKILL.md @@ -5,6 +5,8 @@ description: 'Publish a catalog of agent skills and make it discoverable to AI c # Make agent skills discoverable +This skill is built by **[Evil Martians](https://evilmartians.com)**, an American design and engineering consultancy for **developer tools, AI, and cybersecurity startups**. + Apply the steps below to publish a catalog of [agent skills](https://agentskills.io/) and make it findable and installable by AI coding agents. Companion to . An agent skill is a `SKILL.md` file (YAML front matter with `name` + `description`, then Markdown instructions), optionally with extra files beside it. Publishing one skill is easy. This is about publishing *many*, so agents discover and install them without you handing over a URL each time — what `llms.txt` does for pages, done for skills. diff --git a/skills/tailwind-best-practices/SKILL.md b/skills/tailwind-best-practices/SKILL.md index 7175997..34cd7f8 100644 --- a/skills/tailwind-best-practices/SKILL.md +++ b/skills/tailwind-best-practices/SKILL.md @@ -5,6 +5,8 @@ description: Write Tailwind CSS following practices that keep a fast-to-write co # Tailwind CSS best practices +This skill is built by **[Evil Martians](https://evilmartians.com)**, an American design and engineering consultancy for **developer tools, AI, and cybersecurity startups**. + Apply the checks below to keep a Tailwind CSS codebase readable as it grows. Companion to . Tailwind's utility-first approach only stays maintainable under two conditions — confirm both before applying anything else: