@open330/agt 2026.3.17 → 2026.3.19

package/README.md

@@ -0,0 +1,160 @@
+# agt
+
+> A modular toolkit for extending AI coding agents (Claude Code, Codex CLI, Gemini CLI)
+
+[![npm](https://img.shields.io/npm/v/@open330/agt?color=c0392b&logo=npm&logoColor=white)](https://www.npmjs.com/package/@open330/agt)
+[![GitHub](https://img.shields.io/github/v/release/open330/agt?label=agt)](https://github.com/open330/agt/releases)
+[![License](https://img.shields.io/badge/license-MIT-54a0ff)](https://github.com/open330/agt)
+
+Install and manage **skills**, **personas**, and **hooks** for AI coding agents. Each skill is a self-contained markdown module that gives an agent domain-specific capabilities.
+
+## Quick Start
+
+```bash
+# No install needed — use npx
+npx @open330/agt skill install --profile core
+npx @open330/agt persona install -g --from jiunbae/agent-skills
+
+# Or install globally
+npm install -g @open330/agt
+agt skill install --profile core
+agt persona install -g --all
+```
+
+## Commands
+
+### `agt skill` — Skill Management
+
+```bash
+agt skill install kubernetes-skill        # Install to current workspace
+agt skill install -g git-commit-pr        # Install globally
+agt skill install --profile core          # Install a profile (curated set)
+agt skill install --from user/repo        # Install from a remote skills repo
+agt skill list                            # List all available skills
+agt skill list --installed                # Show installed only
+agt skill update                          # Update all remote-installed skills
+agt skill uninstall kubernetes-skill      # Remove a skill
+```
+
+### `agt persona` — Persona Management
+
+```bash
+agt persona list                                  # List personas
+agt persona install -g security-reviewer          # Install globally
+agt persona install -g --all                      # Install all personas
+agt persona create rust-expert --ai "Rust unsafe" # AI-generated persona
+agt persona review security-reviewer              # Run code review with persona
+agt persona review security-reviewer --codex      # Use Codex CLI
+agt persona show security-reviewer                # View persona details
+```
+
+### `agt run` — Skill Execution
+
+```bash
+agt run "scan for security issues"              # Auto skill matching
+agt run --skill security-auditor "scan"         # Specify skill explicitly
+```
+
+### `agt hook` — Hook Management
+
+```bash
+agt hook install english-coach                  # Install a hook
+agt hook list                                   # List available hooks
+```
+
+### `agt team` — Multi-Agent Teams
+
+```bash
+agt team run review                             # Run a team of agents
+agt team list                                   # List available teams
+```
+
+## Core Skills
+
+Installed by default with `--profile core`:
+
+| Skill | Description |
+|-------|-------------|
+| `git-commit-pr` | Git commit & PR guide with security validation |
+| `context-manager` | Project context auto-loader |
+| `static-index` | Global static context index |
+| `security-auditor` | Repository security audit |
+| `background-implementer` | Parallel multi-LLM implementation |
+| `background-planner` | Parallel multi-LLM planning |
+| `background-reviewer` | Multi-LLM parallel code review |
+
+## Skills Catalog
+
+**33 skills** across 8 categories:
+
+| Category | Skills |
+|----------|--------|
+| **Agents** | background-implementer, background-planner, background-reviewer |
+| **Development** | context-worktree, git-commit-pr, iac-deploy-prep, multi-ai-code-review, playwright, pr-review-loop, task-master |
+| **Business** | bm-analyzer, document-processor, proposal-analyzer |
+| **Integrations** | appstore-connect, discord, google-search-console, kubernetes, notion-summary, obsidian-tasks, obsidian-writer, service-manager, slack, vault-secrets |
+| **ML/AI** | audio-processor, ml-benchmark, model-sync, triton-deploy |
+| **Security** | security-auditor |
+| **Context** | context-manager, static-index |
+| **Meta** | karpathy-guide, skill-manager, skill-recommender |
+
+## Personas
+
+**7 expert personas** for AI-powered code review:
+
+| Persona | Domain |
+|---------|--------|
+| `security-reviewer` | OWASP, auth, injection |
+| `architecture-reviewer` | SOLID, API design, coupling |
+| `code-quality-reviewer` | Readability, complexity, DRY |
+| `performance-reviewer` | Memory, CPU, I/O, scalability |
+| `database-reviewer` | Query optimization, schema, indexing |
+| `frontend-reviewer` | React, accessibility, performance |
+| `devops-reviewer` | K8s, IaC, CI/CD |
+
+## Creating Your Own Skills Repo
+
+You can create your own skills repository that `agt` discovers automatically:
+
+```
+my-skills/
+├── agents/
+│   └── my-agent/
+│       └── SKILL.md
+├── development/
+│   └── my-tool/
+│       └── SKILL.md
+├── personas/
+│   └── my-reviewer/
+│       └── PERSONA.md
+├── profiles.yml
+├── agt.toml
+└── README.md
+```
+
+```bash
+# Others install from your repo
+agt skill install --from you/my-skills
+agt persona install --from you/my-skills
+```
+
+See [full documentation](https://github.com/open330/agt) for SKILL.md format, PERSONA.md format, profiles.yml, and agt.toml specifications.
+
+## Platform Support
+
+| Platform | Architecture |
+|----------|-------------|
+| macOS | arm64 (Apple Silicon), x64 (Intel) |
+| Linux | x64, arm64 |
+
+Binary is automatically downloaded during `npm install`. If the optional platform package fails, a fallback download from GitHub Releases is attempted.
+
+## Links
+
+- **GitHub**: [open330/agt](https://github.com/open330/agt)
+- **Skills Repository**: [jiunbae/agent-skills](https://github.com/jiunbae/agent-skills)
+- **Issues**: [Report bugs](https://github.com/open330/agt/issues)
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open330/agt",
-  "version": "2026.3.17",
+  "version": "2026.3.19",
   "description": "agt — A modular toolkit for extending AI coding agents",
   "bin": {
     "agt": "bin/agt.js"
@@ -9,10 +9,10 @@
     "postinstall": "node scripts/postinstall.js"
   },
   "optionalDependencies": {
-    "@open330/agt-darwin-arm64": "2026.3.17",
-    "@open330/agt-darwin-x64": "2026.3.17",
-    "@open330/agt-linux-x64": "2026.3.17",
-    "@open330/agt-linux-arm64": "2026.3.17"
+    "@open330/agt-darwin-arm64": "2026.3.18",
+    "@open330/agt-darwin-x64": "2026.3.18",
+    "@open330/agt-linux-x64": "2026.3.18",
+    "@open330/agt-linux-arm64": "2026.3.18"
   },
   "repository": {
     "type": "git",

package/platforms/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open330/agt-darwin-arm64",
-  "version": "2026.3.17",
+  "version": "2026.3.18",
   "description": "agt binary for macOS Apple Silicon (arm64)",
   "os": ["darwin"],
   "cpu": ["arm64"],

package/platforms/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open330/agt-darwin-x64",
-  "version": "2026.3.17",
+  "version": "2026.3.18",
   "description": "agt binary for macOS Intel (x64)",
   "os": ["darwin"],
   "cpu": ["x64"],

package/platforms/linux-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open330/agt-linux-arm64",
-  "version": "2026.3.17",
+  "version": "2026.3.18",
   "description": "agt binary for Linux ARM64",
   "os": ["linux"],
   "cpu": ["arm64"],

package/platforms/linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open330/agt-linux-x64",
-  "version": "2026.3.17",
+  "version": "2026.3.18",
   "description": "agt binary for Linux x64",
   "os": ["linux"],
   "cpu": ["x64"],