agent-skills-standard
The open standard for High-Density AI coding instructions. Make your AI smarter, faster, and more consistent across your entire team.
Agent Skills Standard is the open-source framework to distribute, sync, and version-control engineering standards (often called "Cursor Rules" or "Agent Skills") across all major AI agents (Cursor, Claude Code, GitHub Copilot, Windsurf, Trae, Gemini, and more).
📌 Table of Contents
- 💡 Why use this? (For Managers & Teams)
- 🛡️ Security & Trust (For IT)
- 🚀 Quick Start (For Developers)
- 🌍 Supported Frameworks
- ⚙️ Configuration (
.skillsrc) - ❓ FAQ
💡 Why use this? (For Managers & Teams)
Think of Agent Skills Standard as a universal instruction manual for your AI assistant.
When using AI for work, you constantly have to remind it of your "house rules" (e.g., "Make sure to handle errors this way" or "Use this specific layout"). If you feed it too many rules at once, it forgets them or wastes expensive API tokens. If you feed it too few, it writes bad code.
This project solves "The Context Wall" by packaging rules into high-density "Skills" that you can plug into any AI tool instantly.
| Role | Benefit |
|---|---|
| 🚀 Builders | Stop copy-pasting prompts. Get instant, modular standards directly in your IDE. |
| 🛡️ Architects | Scale engineering excellence. Define "house rules" once; sync them to every agent in the team. |
| 📈 Organizations | Lower the technical barrier. Enable non-experts to produce senior-level output via standard "playbooks." |
| 💰 Finance/Ops | Sending a 3,600+ token architect prompt vs. a 413-token skill reduces API costs by ~9x. |
🔄 The Workflow
graph LR
A[Hardcoded Rules] --> B[Wordy Prompts]
B --> C[Loss of Logic & High Cost]
D[Agent Skills] --> E[Progressive Disclosure]
E --> F[High-Density AI Logic]
style F fill:#dcfce7,stroke:#166534
style C fill:#fee2e2,stroke:#991b1b
🛡️ Security & Trust (For IT)
We understand that "injecting" instructions into your AI can sound risky to security teams. Here is how we keep you safe:
- No Code Execution: Skills are pure Markdown/JSON files. They contain text instructions for the AI, not executable code. They cannot run commands on your machine.
- Continuous Benchmarking: Most skills now include an
evals.jsondataset, used to verify AI adherence to constraints via automated regression testing. - Open Source: The entire registry is open source. You can audit every skill file on GitHub before using it.
- Sandboxed: The CLI tool (
agent-skills-standard) runs in user space to download text files. The "skills" themselves run inside the AI's isolated context window, not as OS processes. - Privacy: We do not collect any code or project data. Feedback is only sent if you manually trigger the
feedbackcommand or strongly opt-in.
🚀 Quick Start (For Developers)
Consume engineering standards in your project instantly.
1. Initialize Your Project
Run this once to detect your stack and setup your .skillsrc.
npx agent-skills-standard@latest init
2. Sync Standards
Fetch the latest high-density instructions and install them into your hidden agent folders.
npx agent-skills-standard@latest sync
3. Start Coding
The CLI automatically updates AGENTS.md in your project root. This serves as a universal entry point that helps all AI agents (Cursor, Copilot, etc.) proactively understand when to trigger specific skills based on your project context.
[!TIP] View all CLI Commands: Run
npx agent-skills-standard@latest --helpfor commands likevalidate,feedback, andupgrade.
🌍 Supported Frameworks
The Agent Skills Standard is a modular library. We follow a strict Token Economy—every skill is audited for its footprint in the AI's context window (averaging ~400 tokens) to save you money.
Click to view all 20+ supported frameworks and stacks
| Stack / Category | Key Modules | Version | Typical Saving | Skills |
|---|---|---|---|---|
| Common Patterns | Accessibility, Best Practices, Security | v1.10.0 |
83% | 29 |
| Flutter | BLoC, Riverpod, Clean Architecture | v1.6.1 |
85% | 21 |
| Dart | Language, Tooling | v1.3.1 |
85% | 3 |
| TypeScript | Type Safety, Tooling | v1.3.1 |
82% | 4 |
| JavaScript | Functional Programming, Patterns | v1.3.1 |
89% | 3 |
| React | React 18+, Hooks, Performance | v1.3.1 |
86% | 8 |
| React Native | Architecture, Performance | v1.4.1 |
88% | 13 |
| NestJS | Architecture, Security, BullMQ | v1.4.1 |
82% | 21 |
| Next.js | App Router, SEO, Performance | v1.4.1 |
82% | 18 |
| Angular | Architecture, Signals, RxJS | v1.3.1 |
86% | 16 |
| Android | Compose, Architecture, Serialization | v1.3.1 |
90% | 22 |
| iOS | Architecture, SwiftUI, Concurrency | v1.4.1 |
90% | 15 |
| Swift | Concurrency, Architecture | v1.3.1 |
87% | 8 |
| Kotlin | Language, Concurrency | v1.3.1 |
89% | 4 |
| Java | Language, Concurrency | v1.3.1 |
86% | 5 |
| Spring Boot | Architecture, Security | v1.3.1 |
87% | 10 |
| Go (Golang) | Clean Architecture, Security | v1.3.1 |
88% | 11 |
| PHP | Error Handling, PHP 8+ | v1.3.1 |
86% | 7 |
| Laravel | Solid Patterns, Clean Architecture | v1.3.1 |
82% | 10 |
| Database | PostgreSQL, MongoDB, Redis | v1.2.2 |
85% | 3 |
| Quality Engineering | BA, TDD, Zephyr, Automation | v1.4.0 |
81% | 4 |
[!TIP] View the Complete Registry: For a full list of all 160+ individual skills and token metrics, visit the Skills Directory and Benchmark Report.
⚙️ Configuration (.skillsrc)
The .skillsrc file allows you to customize how skills are synced to your project.
registry: https://github.com/HoangNguyen0403/agent-skills-standard
agents: [cursor, copilot, kiro]
skills:
flutter:
ref: flutter-v1.1.0
# 🚫 Exclude specific sub-skills from being synced
exclude: ['getx-navigation']
# ➕ Include specific skills (supports cross-category 'category/skill' syntax)
include:
- 'bloc-state-management'
- 'react/hooks'
# 🔒 Protect local modifications from being overwritten
custom_overrides: ['bloc-state-management']
❓ FAQ & Contributing
Does this work with Cursor or Gemini?
Yes. Agent Skills Standard is designed to be "Agent Agnostic." It generates the specific configuration files (like `.cursorrules` or `.agent/skills`) that these tools read natively.
How is this different from a system prompt?
System prompts are static and often too long. Agent Skills Standard uses a Discovery Bridge. The AI only "looks up" the specific engineering standards it needs for the file you are currently editing, keeping its memory (context window) free for your actual code.
Can I use this for non-coding tasks (e.g., HR, Finance)?
Absolutely. While many skills here are technical, the framework works for any domain where you want an AI agent to follow consistent, high-density instructions.
🏗 Contributing & Development
Interested in adding standards for NestJS, Golang, or React?
- Propose a Skill: Open an issue with your draft High-Density Content.
- Develop Locally: Fork and add your category to
skills/. - Submit PR: Our CI/CD will validate the metadata integrity before merging.
For detailed architecture logic and token calculation scripts, see CLI Architecture.
📄 License & Credits
- License: MIT
- Author: Hoang Nguyen
📜 Benchmark History
| Version | Date | Skills | Avg Tokens | Savings (%) | Report |
|---|---|---|---|---|---|
| v2.0.0 | 2026-03-25 | 235 | 523 | 86% | Report |
| v1.10.3 | 2026-03-21 | 234 | 505 | 86% | Report |
| v1.10.1 | 2026-03-16 | 229 | 428 | 88% | Report |
| v1.10.0 | 2026-03-16 | 229 | 434 | 88% | Report |
