Skip to content
Back to search

ag-kit

Antigravity-first agent engineering kit with rules, skills, specialist agents, workflows, persistent memory, MCP guidance, orchestration, and a native safety hook.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vudovn--ag-kit/badge.svg)](/listings/vudovn--ag-kit)

HTML

<a href="/listings/vudovn--ag-kit"><img src="/api/listings/vudovn--ag-kit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install into a project

npx @vudovn/ag-kit init

Or install the CLI globally:

npm install -g @vudovn/ag-kit
ag-kit init

Do not add `.agents/` to the project `.gitignore` when Antigravity needs to index rules, skills, or workflows. To keep it local without disabling discovery, add `.agents/` to `.git/info/exclude` instead.

Verify the workspace

npm run check:agents
npm run check:antigravity
npm run test:antigravity

`check:antigravity` is read-only. The default MCP example contains `YOUR_API_KEY`, so the normal doctor reports a warning until the example is configured. Use strict mode only after all placeholders have been resolved:

node .agents/hooks/antigravity-doctor.mjs --strict

Open in Antigravity

After opening the repository as a trusted workspace:

1. Confirm slash commands such as `/plan`, `/coordinate`, and `/orchestrate` are discovered. 2. Confirm relevant skills are selected from `.agents/skills/`. 3. Run a normal command such as `npm test` and confirm it is allowed. 4. Verify the safety hook with a mocked payload rather than executing a destructive command:

printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  | node .agents/hooks/validate-tool-call.mjs

The command must exit non-zero and print `BLOCKED by AG Kit`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 250 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/vudovn/ag-kit/main/web/public/images/logo.png" width="128" height="128" alt="AG Kit">
  3. </p>
  4. <h1 align="center">AG KIT</h1>
  5. <p align="center">
  6. Antigravity-first agent engineering kit with rules, skills, specialist agents, workflows, persistent memory, MCP guidance, orchestration, and a native safety hook.
  7. </p>
  8. <div align="center">
  9. <a href="https://unikorn.vn/p/antigravity-kit?ref=unikorn" target="_blank"><img src="https://unikorn.vn/api/widgets/badge/antigravity-kit?theme=dark" alt="AG Kit on Unikorn.vn" width="210" height="54" /></a>
  10. <a href="https://trendshift.io/repositories/21490" target="_blank"><img src="https://trendshift.io/api/badge/repositories/21490" alt="AG Kit on Trendshift" width="250" height="55" /></a>
  11. <a href="https://launch.j2team.dev/products/antigravity-kit" target="_blank"><img src="https://launch.j2team.dev/badge/antigravity-kit/dark" alt="AG Kit on J2TEAM Launch" width="250" height="54" /></a>
  12. </div>
  13. <p align="center">
  14. <strong>Primary runtime: Google Antigravity</strong><br/>
  15. <a href="./README-VI.md">Tiếng Việt</a> · <a href="./MIGRATION.md">Migration guide</a> · <a href="./PRODUCTION_CHECKLIST.md">Production checklist</a> · <a href="./SECURITY.md">Security</a>
  16. </p>
  17. ---
  18. ## Production profile
  19. AG Kit installs a complete `.agents/` workspace contract. Antigravity is the supported production runtime for this release. Other tools may read the Markdown components, but runtime behavior outside Antigravity is not part of the production compatibility guarantee.
  20. | Capability | Production implementation |
  21. | --- | --- |
  22. | Rules and skill discovery | `.agents/rules/`, `.agents/skills/`, `.agents/workflows/` |
  23. | Specialist routing | 20 role definitions and intelligent-routing skills |
  24. | Persistent context | `.agents/memory/` and context-compression guidance |
  25. | Orchestration | `/coordinate`, `/orchestrate`, Antigravity `/agents` and `/tasks` |
  26. | MCP | Workspace config plus explicit, backup-aware sync helper |
  27. | Tool safety | Native `PreToolUse` gate for high-confidence destructive commands |
  28. | Packaging | Local Antigravity plugin bundle with a SHA-256 content inventory |
  29. | Validation | Toolkit CI, Antigravity Doctor, regression tests, Dependency Review, CLI and web checks |
  30. The native hook is deliberately narrow. It blocks root-filesystem deletion, drive formatting, and raw-disk overwrite patterns while allowing normal project cleanup such as deleting `dist/` or `node_modules/`. It does not replace Antigravity permissions, workspace trust, sandboxing, or human approval.
  31. ## Requirements
  32. - Node.js 22 or newer for repository-level Antigravity tooling.
  33. - Python 3.10 or newer for AG Kit validators and utility scripts.
  34. - A trusted Google Antigravity workspace.
  35. - Git for safe update, review, and rollback workflows.
  36. The published CLI currently supports Node.js 18 or newer; the Antigravity integration checks run on Node.js 22.
  37. ## Quick start
  38. ### Install into a project
  39. ```bash
  40. npx @vudovn/ag-kit init
  41. ```
  42. Or install the CLI globally:
  43. ```bash
  44. npm install -g @vudovn/ag-kit
  45. ag-kit init
  46. ```
  47. Do not add `.agents/` to the project `.gitignore` when Antigravity needs to index rules, skills, or workflows. To keep it local without disabling discovery, add `.agents/` to `.git/info/exclude` instead.
  48. ### Verify the workspace
  49. ```bash
  50. npm run check:agents
  51. npm run check:antigravity
  52. npm run test:antigravity
  53. ```
  54. `check:antigravity` is read-only. The default MCP example contains `YOUR_API_KEY`, so the normal doctor reports a warning until the example is configured. Use strict mode only after all placeholders have been resolved:
  55. ```bash
  56. node .agents/hooks/antigravity-doctor.mjs --strict
  57. ```
  58. ### Open in Antigravity
  59. After opening the repository as a trusted workspace:
  60. 1. Confirm slash commands such as `/plan`, `/coordinate`, and `/orchestrate` are discovered.
  61. 2. Confirm relevant skills are selected from `.agents/skills/`.
  62. 3. Run a normal command such as `npm test` and confirm it is allowed.
  63. 4. Verify the safety hook with a mocked payload rather than executing a destructive command:
  64. ```bash
  65. printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' \
  66. | node .agents/hooks/validate-tool-call.mjs
  67. ```
  68. The command must exit non-zero and print `BLOCKED by AG Kit`.
  69. ## Safe updates and rollback
  70. AG Kit updates are merge-aware. User-owned files and locally modified managed files are preserved by default.
  71. ```bash
  72. ag-kit update --dry-run # Preview the exact plan
  73. ag-kit update # Merge safely and create a backup
  74. ag-kit update --strategy replace # Explicit full replacement, still backed up
  75. ag-kit rollback # Restore the newest pre-update backup
  76. ```
  77. Update metadata is stored in `.agents/.ag-kit/`. Backups are stored in `.ag-kit-backups/` outside the managed toolkit tree. Read [MIGRATION.md](MIGRATION.md) before upgrading an existing installation to the Antigravity-native release.
  78. ## Antigravity-native integration
  79. ### Runtime contract
  80. `.agents/antigravity.json` declares the six supported integration phases and the documented Antigravity CLI capabilities used by AG Kit. It avoids inventing a minimum semantic version when upstream documentation does not define one.
  81. ### Native safety hook
  82. Antigravity loads `.agents/hooks.json`, which registers:
  83. ```json
  84. {
  85. "enabled": true,
  86. "PreToolUse": [
  87. {
  88. "matcher": "run_command",
  89. "command": "node .agents/hooks/validate-tool-call.mjs",
  90. "timeout": 10
  91. }
  92. ]
  93. }
  94. ```
  95. To temporarily disable the AG Kit hook while diagnosing a compatibility issue, set `"enabled": false`, reopen the workspace, and report the payload shape privately if it may contain sensitive data. Do not delete Antigravity's own permission controls.
  96. ### MCP configuration
  97. Review the workspace MCP plan without writing to the home directory:
  98. ```bash
  99. node .agents/hooks/sync-mcp.mjs --check
  100. node .agents/hooks/sync-mcp.mjs --print
  101. ```
  102. After replacing placeholders, explicitly apply to one supported target:
  103. ```bash
  104. node .agents/hooks/sync-mcp.mjs --apply --target suite
  105. node .agents/hooks/sync-mcp.mjs --apply --target cli
  106. ```
  107. Existing servers with the same name are preserved unless `--force` is supplied. A timestamped backup is created before an existing target file is changed. Never commit real MCP credentials.
  108. ### Build and inspect the plugin
  109. ```bash
  110. npm run build:antigravity-plugin
  111. ```
  112. Review `dist/antigravity-plugin/` before local installation. The bundle contains packaged skills, agents, rules, converted workflow commands, the native hook, an MCP example, and `PLUGIN_CONTENTS.json` with SHA-256 entries.
  113. ```bash
  114. agy plugin install ./dist/antigravity-plugin
  115. agy plugin list
  116. ```
  117. Plugin installation is optional; the repository-native `.agents/` workspace remains the source of truth for project development.
  118. ## Included components
  119. | Component | Count | Purpose |
  120. | --- | ---: | --- |
  121. | Agents | 20 | Domain specialist and orchestration role definitions |
  122. | Skills | 47 | Progressive domain knowledge and executable validation helpers |
  123. | Workflows | 13 | Repeatable slash-command procedures |
  124. | Rules | 6 | Workspace-wide routing, safety, design, and coding constraints |
  125. | Memory topics | 4 required topics plus index | Durable project conventions, decisions, preferences, and feedback |
  126. Every agent, skill, workflow, and rule has a SemVer contract. `.agents/manifest.json`, `.agents/manifest.lock.json`, and `.agents/DEPENDENCY_GRAPH.md` make the managed toolkit reproducible and detect drift.
  127. ```bash
  128. npm run generate:agents
  129. npm run check:agents
  130. ```
  131. ## Common workflows
  132. | Command | Purpose |
  133. | --- | --- |
  134. | `/brainstorm` | Explore options and architecture before implementation |
  135. | `/coordinate` | Run separable research or review tasks in parallel, then synthesize |
  136. | `/create` | Create a feature or application with structured gates |
  137. | `/debug` | Perform evidence-based root-cause analysis |
  138. | `/deploy` | Execute production pre-flight checks and deployment workflow |
  139. | `/enhance` | Safely modify an existing codebase |
  140. | `/orchestrate` | Plan, obtain approval, delegate to specialists, and verify |
  141. | `/plan` | Create a detailed implementation plan and checklist |
  142. | `/preview` | Manage local preview servers |
  143. | `/remember` | Save durable project information to memory |
  144. | `/status` | Summarize active work and blockers |
  145. | `/test` | Design and execute tests |
  146. | `/verify` | Prove changes by running checks instead of relying on inspection |
  147. ## Release and production gates
  148. A release candidate is not production-approved until all automated checks and the hands-on Antigravity smoke test in [PRODUCTION_CHECKLIST.md](PRODUCTION_CHECKLIST.md) are complete.
  149. Required GitHub checks:
  150. - Toolkit validation
  151. - CLI tests and package validation
  152. - Web lint, typecheck, build, and audit
  153. - Antigravity native contract
  154. - Dependency Review
  155. AG Kit never requires automatic merge, automatic deployment, or automatic MCP synchronization. Production changes should remain reviewable and reversible.
  156. ## Documentation
  157. - [Antigravity implementation details](.agents/hooks/README.md)
  158. - [Migration guide](MIGRATION.md)
  159. - [Production release checklist](PRODUCTION_CHECKLIST.md)
  160. - [Security policy and runtime threat model](SECURITY.md)
  161. - [Agent flow architecture](AGENT_FLOW.md)
  162. - [Toolkit architecture](.agents/ARCHITECTURE.md)
  163. - [Changelog](CHANGELOG.md)
  164. - [Release setup](.github/RELEASE_SETUP.md)
  165. ## References and attribution
  166. AG Kit is an original open-source implementation of Markdown-based agent engineering patterns. No proprietary source files are included. Runtime integration decisions are based on public Antigravity documentation and codelabs linked in [.agents/hooks/README.md](.agents/hooks/README.md).
  167. ## Support the project
  168. <p align="center">
  169. <a href="https://buymeacoffee.com/vudovn" target="_blank"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me a Coffee" /></a>
  170. </p>
  171. <p align="center"> - or - </p>
  172. <p align="center">
  173. <img src="https://img.vietqr.io/image/mbbank-0779440918-compact.jpg" alt="Buy me coffee" width="200" />
  174. </p>
  175. <p align="center">
  176. <code>CA: Gjpatn3d24dCRhUng7F37K6xJba4R8SDBC18xs1Apump</code>
  177. </p>
  178. ## License
  179. Released under the [MIT License](LICENSE) © [Vudovn](https://github.com/vudovn).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.