neuron-explorer
Steering-first neuron explorer for Qwen3.5-4B: push every MLP neuron, keep every rollout, browse the results
翻譯準備中
一套 Agent Skills 標準與最佳實踐,涵蓋程式語言、框架,協助我們的 AI 代理遵循框架與程式語言的最佳實踐。
AI 翻譯
A collection of Agent Skills Standard and Best Practice for Programming Languages, Frameworks that help our AI Agent follow best practies on frameworks and programming laguages
開發工具TypeScript · PythonGitHub @HoangNguyen0403自行安裝營運者未確認
試用過了嗎? 點一下就好,不需要登入。
正在載入完整 README。 以下為已儲存的摘錄。
The portable SDLC standards layer for AI coding agents. Sync once, then work in your own runtime.
Current release: cli-v2.6.2 — the skill validator accepts package directories under scripts/ (needed by the draw.io diagram pipeline's schema_parsers/); builds on v2.6.1's OWASP Agentic Skills Top 10 hardening (skill-content lockfile, ags verify, enforcing hooks, secret/dependency scanning). See CHANGELOG.md.檢視完整 README ↗The portable SDLC standards layer for AI coding agents. Sync once, then work in your own runtime.
Current release: cli-v2.6.5 — ags sync no longer rejects repo-root LICENSE/NOTICE against release manifests; the skill validator accepts package directories under scripts/ (needed by the draw.io diagram pipeline's schema_parsers/); builds on v2.6.1's OWASP Agentic Skills Top 10 hardening (skill-content lockfile, ags verify, enforcing hooks, secret/dependency scanning). See CHANGELOG.md.
335 ready-to-use coding standards for Cursor, Claude Code, GitHub Copilot, Gemini, Windsurf, Trae, Kiro, Roo and more — synced, versioned, and optimized to use 85% fewer tokens than traditional prompt engineering.
npx agent-skills-standard@latest init
npx agent-skills-standard@latest sync
# Done. Your AI now has portable team standards and SDLC workflows.
If ags -V still shows an old version after reinstalling, check your PATH order. ~/Library/pnpm must come before ~/Library/pnpm/bin, then run hash -r and verify with ags -V again.
Not an engineer? You don't need to run any of the above — just describe your idea to your AI agent. See Getting Started: Product Owner.
Every team has coding standards. But AI agents don't know them.
You end up repeating the same instructions: "Use OnPush change detection", "Always wrap errors with context", "No business logic in handlers". And every time, you face the same trade-off:
.cursorrules = out of date in a week, doesn't scale to teamsAgent Skills Standard turns your engineering rules into modular, version-controlled skills that any AI agent can load on demand.
| Without Skills | With Skills |
|---|---|
| 3,600+ token architect prompt in every chat | ~500 token skill, loaded only when relevant |
| Rules drift across team members' prompts | Single source of truth, synced via CLI |
| Works in one AI tool, copy-paste to others | Works in Cursor, Claude, Copilot, Gemini, Windsurf, Trae, Kiro, Roo |
| AI scans all rules every time (slow, lossy) | Hierarchical lookup: ~25 lines scanned per edit |
Agent Skills Standard does not force you into a new daily command system. ags is for setup, sync, validation, MCP wiring, and updates. After sync, your AI tool receives native assets:
You keep the files in your repo, customize them with .skillsrc and custom_overrides, and run workflows inside the agent you already use.
You run: npx agent-skills-standard sync
What your AI gets:
1. AGENTS.md (router ~20 lines)
"Editing *.ts? Check typescript/_INDEX.md"
2. typescript/_INDEX.md (trigger table)
File Match: typescript-language *.ts, *.tsx, tsconfig.json
Keyword: typescript-security validate, sanitize, auth
3. typescript-language/SKILL.md (loaded on demand)
The actual rules — only when needed.
The AI loads only the skills that match the file being edited and the task at hand. No wasted tokens. No forgotten rules.
This project follows a Zero-Trust architectural model inspired by Rust Token Killer (RTK). Instead of injecting all rules into every prompt (which can cost 5,000+ tokens and cause "prompt loss"), we use a hierarchical loading system.
Detailed documentation is available in ARCHITECTURE.md, covering:
AGENTS.md) -> Category Index (_INDEX.md) -> Skill (SKILL.md).Detects your tech stack and creates a .skillsrc config:
npx agent-skills-standard@latest init
Downloads skills into your AI agent's folders, records ownership in .skills-lock.json v2, and generates the index:
npx agent-skills-standard@latest sync
ags sync --dry-run: Preview what would change without modifying files.ags sync --dry-run --verbose: List every affected file path.ags sync --dry-run --json: Output the install plan as JSON for CI or automation.ags sync --force <paths...>: Overwrite kept files after automatically backing them up..ags/backups/ (latest 3 kept).ags restore <id> or view backups with ags restore --list.ags uninstall [--all] [--agent <agents...>] [--category <categories...>] removes only owned-unchanged files, preserving user edits and backing up first.Add or remove guidance without editing YAML or looking up release tags:
npx agent-skills-standard@latest skills
Categories are checked from your current .skillsrc; newly enabled categories resolve their published release automatically, while existing pins stay untouched. Optionally customize nested skills (with search) or switch a category to its published release, review the full effect, then confirm once — the command saves the selection and installs it for every configured agent. Cancel or an unchanged selection writes nothing. On a real change the command records skills_mode: explicit, so a later ordinary sync will not silently re-add the categories or skills you removed.
Your AI agent now reads AGENTS.md automatically. Skills activate based on what file you're editing and what you ask for.
Works instantly with Cursor, Claude Code, GitHub Copilot, Gemini CLI, Windsurf, Trae, Kiro, and Roo. No plugin or extension needed — the CLI generates each agent's native format.
The CLI distributes skills to disk. The companion MCP server serves them to your AI agent at runtime as explicit tool calls — closing the gap where agents read AGENTS.md but forget to load matched SKILL.md files (especially in sub-agents).
init and sync ask once whether to enable MCP and at what scope. Three choices, recommended in bold:
| Scope | What gets written | Touches $HOME? |
|---|---|---|
project (recommended) | ./mcp-config-snippets/*.json + project-scoped runtime configs (./.mcp.json, ./.cursor/mcp.json, etc.) | ❌ No |
user | All of project + user-home configs (~/.cursor/mcp.json, ~/.gemini/settings.json) | ⚠️ Yes — sync prompts before each user-scope write |
snippets-only | Only ./mcp-config-snippets/*.json — never edits any runtime config | ❌ No |
disabled | Nothing MCP-related | ❌ No |
The CLI never reads or modifies user-home files unless you explicitly choose user scope AND confirm each write. All decisions are recorded in .skillsrc so you're not re-prompted on every sync.
mcp subcommandags mcp status # Show enabled, scope, and per-agent install state
ags mcp enable # Turn on (uses configured scope)
ags mcp disable # Turn off (existing entries kept; use uninstall to clean)
ags mcp scope project # Change scope: project | user | snippets-only | disabled
ags mcp install # One-shot install at the configured scope
ags mcp uninstall --from=all # Remove our entry from project + user configs
ags mcp snippets # Regenerate ./mcp-config-snippets/ without touching configs
Or edit .skillsrc directly:
mcp:
enabled: true
scope: project # project | user | snippets-only | disabled
prompted: true # set to false to be re-asked next sync
hooks subcommandsync installs a PreToolUse hook that reminds your agent to call load_skills_for_files before every edit — advisory by default, never blocks work:
ags hooks status # Show which hook files are installed per agent
ags hooks install # (Re)install the reminder hook — advisory only
ags hooks install --enforce # Claude also BLOCKS edits to SOUL.md, MEMORY.md, .env*, .ssh/, credentials*.json|yaml
ags hooks uninstall # Deregister the hook (keeps the script file)
Independently, ags verify checks installed skill files against .skills-lock.json (written by every sync) to catch drift — a tampered file, a partial write, or a manual edit — ags audit prints the current skill inventory, and ags doctor checks installation health (config, agents, lock file, MCP, hooks, CLI version) with opt-in safe fixes.
Add to your runtime's MCP config:
{
"mcpServers": {
"agent-skills-standard": {
"command": "npx",
"args": ["-y", "agent-skills-standard-mcp"],
},
},
}
Now any sub-agent in any runtime can call load_skills_for_files, audit_session_compliance, etc. Works in Claude Code, Cursor, Antigravity, Kiro, Continue, Gemini CLI — anywhere MCP is supported. Full setup: mcp/README.md.
| Layer | Tool | Runs when | Purpose |
|---|---|---|---|
| Distribution | agent-skills-standard (CLI) | Manually, before AI session | Fetches & writes SKILL.md files; generates AGENTS.md + _INDEX.md |
| Runtime / Enforcement | agent-skills-standard-mcp (MCP) | Auto-launched by the AI runtime | Serves matched SKILL.md to live agents on demand; provides audit log |
Use both when you want enforcement receipts: the CLI installs the rules, the MCP makes sure agents load them.
The registry now ships a compact lifecycle that agents can run natively after sync:
| Stage | Synced Workflow | Output |
|---|---|---|
| Route | sdlc | next workflow and blockers |
| Brainstorm | brainstorm-feature | product-brief.md |
| Plan | plan-feature | PRD, decisions, task slices |
| Design | design-solution | architecture, contracts, ADR |
| Readiness | implementation-readiness | go/no-go before code |
| Build | implement-feature / dev-fix | implementation handoff |
| Review | review-ticket | multi-lens PR/ticket verdict |
| Verify | verify-work / verify-bug | walkthrough.md evidence |
| Security | pentest / security-test | hacker report, PoC, SAST logs |
The registry now includes the common-telemetry skill and a companion MCP tool get_session_cost(). At the end of every workflow, the agent can now report MCP-observed session telemetry plus exact-or-estimated token cost when the host runtime supplies usage and pricing data.
See SDLC Workflow Quick Reference.
ags init includes framework skills plus shared SDLC support categories when the registry provides them:
| Surface | How It Syncs |
|---|---|
quality-engineering | Included as a skill category for BA review, Jira traceability, QA standards, browser/mobile verification, and Zephyr coverage |
specialists | Converted directly into native sub-agent files for Jira analysis, codebase scouting, architecture/security review, AC verification, test gaps, PR metadata, Zephyr/Confluence lookup, PR comments, integration tests, and TC creation |
External tasking MCPs such as Jira, Azure DevOps, and Zephyr are integration points, not required dependencies. Workflows should use them when already connected, but every workflow must still work from local tickets, specs, and evidence files so teams can customize their own automation stack.
For security-sensitive autonomous review, prefer a sandboxed runtime with least-privilege tools, isolated credentials, and default-deny outbound network. That aligns with the safety direction shown by NVIDIA OpenShell's policy-enforced sandboxes and Anthropic's warning that PR security review should stay on trusted inputs unless the runtime is hardened.
For review workflows specifically, the next-tier operating model is:
In practice that means:
code-review and review-ticket can emit review-delivery.md as the sanitized packet for channel handoff or approved PR comment publicationcodebase-review.md separately from security-review.md so engineering health and exploitability stay distinctFor repository enforcement, keep the workflows and skills lean: the source of truth lives in skills/ and .agents/workflows/, not in MCP-only artifact helpers, fixture packs, or replay chains.
See also Learning From agentic-ai and the Optional MCP Integration Guide and UI Automation Drivers.
Every skill is audited for token efficiency (averaging ~500 tokens) and tested with automated evals.
| Stack | Key Skills | Version | Skills |
|---|---|---|---|
| Common Patterns | Best Practices, Security, TDD, Architecture Diagrams | v2.5.0 | 38 |
| Flutter | BLoC, Riverpod, Architecture, Concurrency | v1.7.1 | 22 |
| React | Hooks, Performance, State Management | v1.3.6 | 8 |
| React Native | Architecture, Navigation, Performance | v1.4.4 | 13 |
| Next.js | App Router, Server Components, Caching, ISR | v1.4.5 | 18 |
| Angular | Signals, Components, RxJS, SSR | v1.4.2 | 15 |
| NestJS | Architecture, Security, BullMQ | v1.4.5 | 21 |
| TypeScript | Type Safety, Security, Tooling | v1.3.3 | 4 |
| JavaScript | ES2024+, Patterns, Tooling | v1.3.4 | 3 |
| Go (Golang) | Clean Arch, Concurrency | v1.3.5 | 11 |
| Python | Clean Arch, Async, Testing, Security | v1.0.0 | 9 |
Full skill list with token metrics: Skills Directory | Benchmark Report | Public Proof
The .skillsrc file controls what gets synced:
registry: https://github.com/HoangNguyen0403/agent-skills-standard
agents: [cursor, copilot, claude, gemini]
# `ags skills` records explicit mode after a real selection change so ordinary
# sync no longer re-adds categories you deliberately removed.
# skills_mode: explicit
# Standard registry skills
skills:
flutter:
ref: flutter-v1.6.3
exclude: ["getx-navigation"] # Don't use GetX? Exclude it.
custom_overrides: ["bloc-state"] # Protect your local modifications.
react:
ref: react-v1.3.3
golang:
ref: golang-v1.3.2
common:
ref: common-v2.0.3
# Local custom standalone skills
custom_skills:
- path: "./.skills/my-custom-rule.md"
triggers: ["*.ts", "keyword"]
Skills are package-aware: if your Flutter project uses BLoC but not GetX, just exclude the GetX skills. The AI only sees what's relevant to your stack. The custom_skills feature allows you to index your own .md files directly into AGENTS.md and _INDEX.md, ensuring your project-specific rules are always visible to the AI.
workflows:
- sdlc
- brainstorm-feature
- plan-feature
- design-solution
- implement-feature
- verify-work
- pentest
- security-test
- deploy-release
- publish-notes
- retro-learn
Workflows sync to the native surface for each selected agent. Keep .agents/workflows as the canonical source in this registry; Codex receives generated workflow skills under .codex/skills/<workflow>/SKILL.md.
Every configured provider, including a provider-only install, gets the canonical workflow body installed once at .agents/workflows/<name>.md, and native exports are derived from that same content. .skills-lock.json records the verified catalog (path, digest, registry ref, resolved commit and native bindings), so MCP list_workflows / get_workflow return what native invocation actually installed. A native export whose bytes differ from the deterministic output (user edit, unowned file, or another alias at the same path) is stored as a conflict instead of a verified binding, so parity is not claimed. Lookup reports managed, local_source (no lock; no parity claim), unverified (lock without catalog metadata; run ags sync) or unavailable — an absent workflow is never replaced by unrelated content. An interrupted or partial sync keeps the previous catalog instead of claiming alignment.
Every AI agent follows the same hierarchical lookup — no agent-specific setup needed:
AGENTS.md (compact router, ~20 lines)
|
| "Editing *.go? Read golang/_INDEX.md"
v
_INDEX.md (per-category trigger table)
|
| File Match: golang-database internal/adapter/repository/**
| Keyword: golang-security encrypt, auth, validate
v
SKILL.md (loaded on demand, ~500 tokens)
|
| The actual engineering rules
v
Your AI writes code that follows your standards.
File Match = auto-checked when you edit a matching file. Keyword Match = checked only when your prompt mentions the concept.
This means editing a .ts file loads 6 relevant skills instead of 27 — no confusion, no token waste.
Picture a developer in Cursor or Claude Code asking:
"Add a POST /orders endpoint that validates the body and returns 201."
Here's what happens with the MCP, step by step.
src/orders/orders.controller.ts
// Tool call from the agent
{
"name": "load_skills_for_files",
"arguments": { "files": ["src/orders/orders.controller.ts"] },
}
matched-by skill
────────────────────────────────────────── ─────────────────────────────────────
file:**/*.ts typescript/typescript-language
file:**/*.controller.ts nestjs/nestjs-api-standards
file:**/*.controller.ts nestjs/nestjs-controllers-services
file:**/*.controller.ts nestjs/nestjs-file-uploads
file:**/*.controller.ts nestjs/nestjs-real-time
file:**/*.controller.ts nestjs/nestjs-transport
composite via typescript/typescript-language common/common-best-practices
composite via nestjs/nestjs-api-standards common/common-api-design
composite via nestjs/nestjs-file-uploads common/common-security-standards
composite via nestjs/nestjs-real-time common/common-performance-engineering
composite via nestjs/nestjs-transport system-design/system-design-principles
| From skill | Rule the agent now follows |
|---|---|
typescript-language | Strict typing, unknown over any, satisfies operator |
nestjs-controllers-services | Controllers stay thin; logic lives in services |
nestjs-api-standards | DTOs with class-validator, consistent error envelopes |
nestjs-transport | @HttpCode(201), ParseUUIDPipe, response shape |
common-best-practices | Functions < 30 lines, guard clauses, intention-revealing names |
common-api-design | Status codes, pagination, idempotency, OpenAPI conventions |
common-security-standards | Authn/authz, input sanitization, secret handling |
system-design-principles | Module boundaries, coupling rules |
common-performance-engineering | Async patterns, N+1 query checks |
{ "name": "audit_session_compliance" }
# Session compliance
Skills loaded: 11
- common/common-api-design
- common/common-best-practices
- common/common-performance-engineering
- common/common-security-standards
- system-design/system-design-principles
- nestjs/nestjs-api-standards
- nestjs/nestjs-controllers-services
- nestjs/nestjs-file-uploads
- nestjs/nestjs-real-time
- nestjs/nestjs-transport
- typescript/typescript-language
The agent reads AGENTS.md (maybe), walks the router (maybe), reads the matched _INDEX.md (maybe), and reads matched SKILL.md files (often skipped — especially in sub-agents that don't inherit CLAUDE.md). Result:
| With MCP | Without MCP | |
|---|---|---|
typescript-language rules | ✅ Loaded | ⚠️ Sometimes |
nestjs-* framework rules | ✅ All 5 loaded | ⚠️ One or two if lucky |
common-best-practices (function size, naming, guard clauses) | ✅ Loaded via composite | ❌ Almost never |
common-api-design (status codes, pagination) | ✅ Loaded via composite | ❌ Almost never |
common-security-standards (input validation, auth) | ✅ Loaded via composite | ❌ Almost never |
| Provable audit log of what informed the code | ✅ audit_session_compliance | ❌ None |
Behavior in sub-agents (tdd-implementer, architecture-guard, etc.) | ✅ Complete body per request | ❌ Worse — sub-agents inherit nothing |
That's the reason the MCP exists: every request returns the complete matched bodies, read at request time, so one actor's earlier lookup can never suppress another context's instructions. Host propagation, scheduled invocation and enforcement remain host-owned; the MCP records selection and returned bodies, not comprehension.
Agent Skills Standard supports Specialist Sub-Agents. These are focused personas (for example @specialist-tdd-implementer, @specialist-architecture-guard, @specialist-ac-verifier) that you can delegate specific parts of your workflow to.
.claude/agents, .codex/agents, .cursor/agents, .gemini/agents, .opencode/agents, and .github/agents (<name>.agent.md for Copilot). Serialized definitions are not proof of runtime support: native delegation status is version-, revision- and control-scoped, and reported as not_verified until live execution evidence exists.tools: [] for a declared all-unknown allowlist); Claude projects native and universal tool names; Gemini projects a declared native tools list verbatim, including an explicit empty one; Codex and OpenCode disclose declared restrictions instead of emitting unenforced keys.Skills are text files, not code. They cannot execute commands, access your filesystem, or make network requests. This repo's posture is mapped against the OWASP Agentic Skills Top 10 — see docs/SECURITY.md for the full AST01–AST10 coverage table. Here's the full picture:
Every skill in this repository is automatically scanned by NVIDIA SkillSpector — a purpose-built security scanner for AI agent skills. The pipeline checks 64 vulnerability patterns across 16 categories including prompt injection, data exfiltration, privilege escalation, supply chain attacks, and MCP tool poisoning.
skills/** must pass the scan before mergingskillspector-verified-vYYYYMMDD tag is created on main when all scanned skills pass the gatecommon-owasp, common-pentest-methodology, common-llm-security — are excluded from the automated scan; a real CI run confirmed their SKILL.md legitimately trips the scanner from educational content. The other 4 (including common-security-audit) are scanned like every other skillSee docs/SECURITY.md for the full security policy, threshold definitions, and instructions for running the scanner locally before submitting a PR.
AGS_TELEMETRY=1) writes per-session skill-load counts to ~/.agent-skills-standard/telemetry.jsonl and is never uploaded; see docs/FRESHNESS.md; a project's .skillsrc can also enable it, in which case the MCP prints a startup noticeags feedbackdescription, body, and references/*.md are scanned against known injection patterns (zero-width/bidi characters, imperative HTML comments, curl-pipe-to-shell, etc.) at CI time and index-generation timeags sync writes .skills-lock.json (a sha256 per installed file); run ags verify any time to detect drift between what was fetched and what's actually on diskrisk_tier, allowed-tools, and permissions in frontmatter, projected onto each platform's native mechanism where one exists (e.g. Codex sandbox_mode)ags hooks install --enforce makes Claude's PreToolUse hook actually block (not just remind) edits to a fixed identity/secret deny-list (SOUL.md, MEMORY.md, .env*, .ssh/, credentials*.json|yaml)evals.json datasets that verify AI adherence to constraints via regression testsAGENTS.md enforces a mandatory audit: the AI must declare which skills it loaded before writing code, preventing silent rule-skippingnpm publish --provenance on every published packagerevocations list checked on every sync (ags audit prints the current inventory)skills/<category>/, include evals.json.See ARCHITECTURE.md for design details and CLI Architecture for service internals.
benchmark-report.md measures skill size — tokens, structure, rubric score. It's fast and free, but it can't tell you whether a skill actually changes agent behavior. evals-report.md does: each skill's real eval prompts are answered by an agent twice — once with no skill loaded (baseline), once with it loaded (with-skill) — and scored deterministically against the assertions already in evals/evals.json.
This runs inside any coding agent's normal chat session (Claude Code, Copilot, Codex, Antigravity — no API key needed beyond what you already use to run that agent), and every result is independently verifiable afterward with no agent involved:
pnpm evals:verify -- --all # re-score every committed run, no API key, no LLM call
See docs/EVALS.md for the full protocol, the trust model, and how to run your own category.
| Version | Date | Skills | Avg Tokens | Savings (%) | Report |
|---|---|---|---|---|---|
| v2.6.0 | 2026-07-10 | 264 | 528 | 46% | Report |
| v2.4.7 | 2026-06-15 | 251 | 551 | 85% | Report |
| v2.4.6 | 2026-06-10 | 251 | 548 | 85% | Report |
| v2.4.1 | 2026-05-18 | 247 | 540 | 85% | Report |
| v2.4.0 | 2026-05-14 | 246 | 540 | 85% | Report |
| v2.3.0 | 2026-05-13 | 246 | 540 | 85% | Report |
| v2.2.2 | 2026-05-09 | 249 | 539 | 85% | Report |
| v2.2.0 | 2026-04-22 | 242 | 538 | 85% | Report |
| Spring Boot | Architecture, Security, JPA | v1.3.3 | 10 |
| Android | Compose, Navigation 3, Edge-to-Edge, AGP 9 | v1.4.1 | 26 |
| iOS | SwiftUI, Arch, Persistence | v1.4.5 | 15 |
| Swift | Concurrency, Memory | v1.3.5 | 8 |
| Kotlin | Coroutines, Language | v1.3.3 | 4 |
| Java | Records, Virtual Threads | v1.3.3 | 5 |
| PHP | PHP 8.4+, Error Handling | v1.3.5 | 7 |
| Laravel | Eloquent, Clean Arch | v1.3.4 | 10 |
| Dart | Null Safety, Sealed Classes | v1.3.5 | 3 |
| Database | PostgreSQL, MongoDB, Redis, Migrations | v1.3.5 | 7 |
| Quality Engineer | BA, TDD, Zephyr, Test Gen | v1.5.0 | 7 |
| Specialists | Jira, Review, QA, Security, Zephyr, Diagramming | v1.5.0 | 19 |
| v2.1.2 |
| 2026-04-11 |
| 237 |
| 516 |
| 86% |
| Report |
| v2.1.1 | 2026-04-11 | 237 | 516 | 86% | Report |