Skip to content

Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages

feat: migrate to npx skills standard, add llms.txt, restructure to /skills, and polish README

Leonxlnx3206dd44fce9
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 0000000..c9ca993
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1,11 @@
+# Copilot Instructions: Taste Standard
+
+> **Note:** GitHub Copilot automatically reads this file to set its global behavior. By including this in the `.github` folder, Copilot stops writing generic "slop" code and adheres to the premium Taste Skill standards.
+
+## The "Anti-Slop" Manifesto for Copilot
+
+1. **No Generic UI:** Stop generating default SaaS templates. Use high contrast, strong typographic hierarchy, and extreme care for alignment.
+2. **Premium Whitespace:** Elements need room to breathe. Use proportional `clamp()` spacing over rigid padding.
+3. **Cinematic Motion:** Never use linear easing. All animations must use spring physics (`stiffness: 100, damping: 20` or similar).
+4. **Complete Implementation:** No placeholders. No `// TODO: add actual code here`. Write the full, working implementation every single time.
+5. **Contextual Awareness:** For deep style configurations, read the localized `SKILL.md` files in the `skills/` directory.
diff --git a/README.md b/README.md
index 5ed98bc..fca2e9c 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,11 @@
A collection of skills that improve how AI tools write frontend code. Instead of generating generic, boring interfaces, the AI builds modern, premium designs with proper animations, spacing, and visual quality.
+[![Agent Skills](https://img.shields.io/badge/Agent_Skills-Compatible-blue?style=flat-square)](https://github.com/vercel-labs/agent-skills)
+[![GitHub stars](https://img.shields.io/github/stars/Leonxlnx/taste-skill?style=flat-square&color=yellow)](https://github.com/Leonxlnx/taste-skill/stargazers)
+[![AI Supported](https://img.shields.io/badge/AI_Supported-Cursor_%7C_Claude_%7C_Antigravity-black?style=flat-square)](#)
+[![Premium UI](https://img.shields.io/badge/Design-Premium_Frontend-white?style=flat-square&color=gray)](#)
+
## Feedback & Contributions
I'd love to hear your thoughts! If you have suggestions or find any bugs:
@@ -10,57 +15,33 @@ I'd love to hear your thoughts! If you have suggestions or find any bugs:
- DM me on [x.com/lexnlin](https://x.com/lexnlin)
- Email me at [[email protected]](mailto:[email protected])
-## Skills
-
-There are seven skills in this project. Each one lives in its own folder and contains a `SKILL.md` file.
-
-### 1. taste-skill
-The main design skill. Teaches the AI how to write good-looking frontend code from scratch. Covers layout, typography, colors, spacing, motion, and overall visual quality.
-
-### 2. redesign-skill
-For upgrading existing projects. Instead of rebuilding from zero, this skill walks the AI through auditing what's already there and fixing the biggest design problems first.
-
-### 3. soft-skill
-Focuses on making things look and feel expensive. Covers premium fonts, big breathing whitespace, layered card designs with depth, smooth spring-based animations, and floating navigation. Bans all the generic defaults that make AI output look like a template.
+## Installing
-### 4. output-skill
-Stops the AI from being lazy. Prevents placeholder comments, skipped code blocks, and half-finished outputs. Forces the AI to actually write everything instead of cutting corners.
+Works via CLI for all major AI coding agents (Cursor, Antigravity, Claude Code, Codex, Windsurf, Copilot, etc.):
-### 5. minimalist-skill
-For clean, editorial-style interfaces inspired by tools like Notion and Linear. Enforces warm monochrome palettes, serif/sans-serif typographic contrast, massive whitespace, flat bento grids with crisp hairline borders, and muted pastel accents. Blocks gradients, heavy shadows, and generic SaaS patterns.
+```bash
+npx skills add https://github.com/Leonxlnx/taste-skill
+```
-### 6. brutalist-skill ⚠️ `BETA`
-Raw mechanical interfaces fusing Swiss typographic print with CRT terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, and analog degradation effects like halftones, scanlines, and dithering. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints.
-> **Status: Prototype** — This skill is an early draft and still fairly generic. Expect refinements, more specific component specs, and tighter constraints in future versions.
-
-### 7. stitch-skill
-Google Stitch-compatible semantic design system. Converts the taste-skill's anti-slop engineering directives into Stitch's native `DESIGN.md` format — descriptive natural-language rules paired with precise hex values that Stitch's AI agent interprets to generate premium, non-generic interfaces. Includes the SKILL.md agent instructions and a ready-to-import DESIGN.md file.
-
-## How to Use
-
-1. Copy the `SKILL.md` file from the skill folder you need into your project.
-2. Tell your AI to read and follow it. In most editors you can just reference it directly (e.g. `@SKILL.md` in Cursor).
+## Skills
-That's it. The AI reads the file and follows the rules.
+| Skill | Description |
+| --- | --- |
+| **taste-skill** | The main design skill for premium frontend code. Covers layout, typography, colors, spacing, and motion. |
+| **redesign-skill** | For upgrading existing projects by auditing and fixing design problems first. |
+| **soft-skill** | Focuses on an expensive, soft UI look with premium fonts, whitespace, depth, and smooth spring animations. |
+| **output-skill** | Stops the AI from being lazy. Prevents placeholder comments, skipped code blocks, and half-finished outputs. |
+| **minimalist-skill** | For clean, editorial-style interfaces inspired by tools like Notion and Linear. Monochrome, crisp borders. |
+| **brutalist-skill** | ⚠️ `BETA` Raw mechanical interfaces fusing Swiss typographic print with CRT terminal aesthetics. |
+| **stitch-skill** | Google Stitch-compatible semantic design rules for premium AI UI generation. Includes DESIGN.md for export. |
## Settings (taste-skill only)
The taste skill has three settings at the top of the file. Change these numbers (1-10) depending on what you're building:
-**DESIGN_VARIANCE** — How experimental the layout is.
-- 1-3: Clean, centered, standard grids.
-- 4-7: Overlapping elements, varied sizes.
-- 8-10: Asymmetric, lots of whitespace, very modern.
-
-**MOTION_INTENSITY** — How much animation there is.
-- 1-3: Almost none. Simple hover effects.
-- 4-7: Fade-ins, smooth scrolling.
-- 8-10: Magnetic effects, spring physics, scroll-triggered animations.
-
-**VISUAL_DENSITY** — How much content fits on one screen.
-- 1-3: Big and spacious. One element at a time. Luxury feel.
-- 4-7: Normal spacing. Like a typical app or website.
-- 8-10: Dense and compact. Dashboards, data-heavy interfaces.
+- **DESIGN_VARIANCE** — How experimental the layout is. (1-3: Clean/centered | 8-10: Asymmetric/modern)
+- **MOTION_INTENSITY** — How much animation there is. (1-3: Simple hover | 8-10: Magnetic/scroll-triggered)
+- **VISUAL_DENSITY** — How much content fits on one screen. (1-3: Spacious/luxury | 8-10: Dense dashboards)
## Examples
@@ -73,9 +54,9 @@ Created with taste-skill:
## Support the project
-If you find **taste-skill** useful, consider sponsoring the development.
+If you find **taste-skill** useful, consider sponsoring the development.
-[Sponsor on GitHub](https://github.com)
+[Sponsor on GitHub](https://github.com/sponsors/Leonxlnx)
### Current Sponsors
- *Your name could be here!*
diff --git a/brutalist-skill/SKILL.md b/skills/brutalist-skill/SKILL.md
similarity index 100%
rename from brutalist-skill/SKILL.md
rename to skills/brutalist-skill/SKILL.md
diff --git a/skills/llms.txt b/skills/llms.txt
new file mode 100644
index 0000000..c22913c
--- /dev/null
+++ b/skills/llms.txt
@@ -0,0 +1,7 @@
+taste-skill: The main design skill for premium frontend code. Covers layout, typography, colors, spacing, and motion.
+redesign-skill: For upgrading existing projects by auditing and fixing design problems.
+soft-skill: Focuses on an expensive, soft UI look with premium fonts, whitespace, depth, and smooth animations.
+output-skill: Prevents AI from being lazy, skipping code blocks, or using placeholder comments.
+minimalist-skill: Enforces clean, editorial-style interfaces (Notion/Linear style) with strict monochrome palettes.
+brutalist-skill: Raw mechanical interfaces, Swiss typography, extreme scale contrast. (Beta)
+stitch-skill: Google Stitch-compatible semantic design rules for premium AI UI generation.
diff --git a/minimalist-skill/SKILL.md b/skills/minimalist-skill/SKILL.md
similarity index 100%
rename from minimalist-skill/SKILL.md
rename to skills/minimalist-skill/SKILL.md
diff --git a/output-skill/SKILL.md b/skills/output-skill/SKILL.md
similarity index 100%
rename from output-skill/SKILL.md
rename to skills/output-skill/SKILL.md
diff --git a/redesign-skill/SKILL.md b/skills/redesign-skill/SKILL.md
similarity index 100%
rename from redesign-skill/SKILL.md
rename to skills/redesign-skill/SKILL.md
diff --git a/soft-skill/SKILL.md b/skills/soft-skill/SKILL.md
similarity index 100%
rename from soft-skill/SKILL.md
rename to skills/soft-skill/SKILL.md
diff --git a/stitch-skill/DESIGN.md b/skills/stitch-skill/DESIGN.md
similarity index 100%
rename from stitch-skill/DESIGN.md
rename to skills/stitch-skill/DESIGN.md
diff --git a/stitch-skill/SKILL.md b/skills/stitch-skill/SKILL.md
similarity index 100%
rename from stitch-skill/SKILL.md
rename to skills/stitch-skill/SKILL.md
diff --git a/taste-skill/SKILL.md b/skills/taste-skill/SKILL.md
similarity index 100%
rename from taste-skill/SKILL.md
rename to skills/taste-skill/SKILL.md