--- slug: "agentup" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/vurakit/agentup@main/README.md" repo: "https://github.com/vurakit/agentup" source_file: "README.md" branch: "main" --- # AgentUp ![Version](https://img.shields.io/badge/version-1.5.0-blue) ![Languages](https://img.shields.io/badge/languages-Go%20%7C%20Node.js%20%7C%20Rust%20%7C%20PHP%20%7C%20Mobile-green) ![Platforms](https://img.shields.io/badge/platforms-Claude%20%7C%20Cursor%20%7C%20Windsurf%20%7C%20Antigravity-purple) ![Python](https://img.shields.io/badge/python-3.x-yellow) ![License](https://img.shields.io/badge/license-MIT-orange) **AI skills that make your coding assistant write production-grade code.** AgentUp injects curated knowledge — design patterns, package recommendations, architecture guidelines, and best practices — directly into your AI coding environment. One command, instant upgrade. [![PayPal](https://img.shields.io/badge/PayPal-Support%20this%20project-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/thinhntq) --- ## Quick Start ```bash npx @agentup/cli init ``` Pick your platform and languages interactively, or pass flags directly: ```bash npx @agentup/cli init --platform claude --lang go npx @agentup/cli init --platform cursor --lang nodejs npx @agentup/cli init --platform windsurf --lang go,nodejs npx @agentup/cli init --platform antigravity --lang rust npx @agentup/cli init --platform cursor --lang php npx @agentup/cli init --platform claude --lang rust --no-frontend ``` **Supported platforms:** `claude` · `cursor` · `windsurf` · `antigravity` **Supported languages:** `go` · `nodejs` · `rust` · `php` · `mobile` · `python` _(coming soon)_ · `database` _(coming soon)_ **Frontend skill** (UI/UX) is installed by default alongside any language skill. --- ## What Gets Installed Running `agentup init` copies skill files into your project: ``` your-project/ └── .claude/skills/ # (or .cursor/skills/, .windsurf/skills/) ├── go/ │ ├── data/ # 13 CSV knowledge databases │ ├── scripts/ # BM25 search engine (Python, zero deps) │ └── templates/ ├── nodejs/ │ ├── data/ # 14 CSV knowledge databases │ └── scripts/ ├── rust/ │ ├── data/ # 14 CSV knowledge databases │ └── scripts/ ├── php/ │ ├── data/ # 21 CSV knowledge databases │ └── scripts/ ├── mobile/ │ ├── data/ # 22 CSV knowledge databases │ └── scripts/ └── frontend/ ├── data/ # UI/UX knowledge databases └── scripts/ ``` It also appends the skill workflow to your AI config file (`CLAUDE.md`, `.cursorrules`, `.windsurfrules`), so your AI assistant automatically uses it. --- ## Skills ### Go Backend 13 searchable knowledge domains for production Go code. | Domain | Coverage | | ------------- | --------------------------------------------------------------------- | | `pattern` | Functional Options, Table-Driven, Middleware, Pipeline, Repository... | | `package` | Package recommendations by use case | | `error` | errors.Is, fmt.Errorf %w, sentinel errors, custom types | | `concurrency` | Goroutines, channels, worker pools, context cancellation | | `perf` | Allocations, profiling, sync.Pool, connection pooling | | `test` | Table-driven, httptest, fuzzing, benchmarks, mocking | | `interface` | Interface design, composition, contracts | | `arch` | Project structure, Clean Architecture, DDD | | `idiom` | Go conventions, naming, style | | `anti` | Common anti-patterns to avoid | | `tooling` | go vet, golangci-lint, pprof, dlv | | `module` | Go modules, versioning, workspaces | **10 stack guidelines:** `web-gin` · `web-echo` · `web-fiber` · `web-stdlib` · `grpc` · `cli` · `database` · `microservice` · `cloud-native` · `data-pipeline` **Architecture generator:** multi-domain search that produces complete project architecture, package choices, error strategy, and folder structure. --- ### Node.js / TypeScript 14 searchable knowledge domains for production Node.js/TypeScript code. | Domain | Coverage | | ------------ | --------------------------------------------------------- | | `pattern` | Factory, Strategy, Middleware, Decorator, Observer... | | `package` | Package recommendations by use case | | `error` | Custom error classes, Result types, error boundaries | | `async` | Promises, async/await, concurrency patterns | | `typescript` | Generics, discriminated unions, utility types, decorators | | `perf` | Event loop, memory leaks, clustering, caching | | `test` | Vitest, mocking, integration tests, snapshot tests | | `arch` | Modular monolith, Clean Architecture, feature folders | | `idiom` | Node.js conventions, ESM, barrel exports | | `anti` | Callback hell, blocking I/O, memory leaks | | `tooling` | ESLint, Prettier, tsx, esbuild, turborepo | | `module` | npm workspaces, monorepo, versioning | **12 stack guidelines:** `web-express` · `web-fastify` · `web-nestjs` · `web-hono` · `web-nextjs` · `web-remix` · `orm-prisma` · `orm-drizzle` · `database` · `graphql` · `auth` · `realtime` --- ### Rust 14 searchable knowledge domains for production Rust code. | Domain | Coverage | | ------------- | ------------------------------------------------------ | | `pattern` | Builder, Newtype, Typestate, RAII, Iterator adaptor... | | `crate` | Crate recommendations by use case | | `error` | thiserror, anyhow, custom error types, Result chaining | | `concurrency` | Tokio tasks, channels, Mutex, RwLock, rayon | | `trait` | Trait objects, blanket impls, associated types | | `perf` | Zero-cost abstractions, SIMD, allocator, profiling | | `test` | Unit, integration, property-based, cargo-nextest | | `arch` | Domain-driven design, hexagonal, workspace layout | | `idiom` | Ownership, borrowing, lifetimes, idiomatic patterns | | `anti` | Clone overuse, unwrap in prod, blocking async | | `tooling` | clippy, rustfmt, cargo-audit, flamegraph | | `module` | Workspace, feature flags, crate versioning | | `unsafe` | Raw pointers, FFI, unsafe blocks, soundness | **11 stack guidelines:** `web-axum` · `web-actix` · `web-warp` · `web-rocket` · `grpc` · `database` · `cli` · `auth` · `async-runtime` · `wasm` · `embedded` --- ### PHP 12 searchable knowledge domains for production PHP code. | Domain | Coverage | | ------------ | ------------------------------------------------------ | | `pattern` | Repository, Factory, Observer, Strategy, Middleware... | | `package` | Composer package recommendations by use case | | `error` | Custom exceptions, handlers, logging, API errors | | `perf` | OPcache, indexing, eager loading, caching | | `test` | PHPUnit, Pest, factories, mocking, feature tests | | `security` | OWASP top 10, SQL injection, XSS, CSRF, auth | | `interface` | SOLID, type safety, enums, readonly, PSR | | `arch` | MVC, DDD, Hexagonal, CQRS, Modular Monolith | | `idiom` | PHP 8+, match, arrow functions, strict types | | `anti` | God controller, N+1, mass assignment, no validation | | `tooling` | PHPStan, Pint, Rector, Xdebug, Horizon | | `dependency` | Composer, PSR-4, versioning, security audit | **8 stack guidelines:** `laravel` · `symfony` · `codeigniter` · `slim` · `api-platform` · `livewire` · `database` · `queue` --- ### Mobile 12 searchable knowledge domains for production mobile code. | Domain | Coverage | | ------------ | --------------------------------------------------------------- | | `pattern` | MVVM, BLoC, Clean Architecture, Repository, MVI, VIPER, Redux | | `package` | Package recommendations by use case (250+ mobile packages) | | `error` | Either types, crash reporting, offline queues, error boundaries | | `perf` | Widget rebuilds, list optimization, memory, battery, app size | | `test` | Widget tests, BLoC tests, golden tests, integration, coverage | | `security` | Secure storage, certificate pinning, obfuscation, auth | | `interface` | Responsive layout, accessibility, Material 3, dark mode | | `arch` | Clean Architecture, feature-first, DDD, offline-first, monorepo | | `idiom` | Dart null safety, extensions, pattern matching, async/await | | `anti` | Massive widgets, setState abuse, memory leaks, deep nesting | | `tooling` | Flutter DevTools, Fastlane, FVM, Mason, Xcode Instruments | | `dependency` | pubspec.yaml, CocoaPods, Gradle, monorepo, version management | **9 stack guidelines:** `flutter` · `react-native` · `swiftui` · `jetpack-compose` · `kotlin-multiplatform` · `capacitor` · `expo` · `native-ios` · `native-android` --- ### UI/UX Frontend Installed by default with any language skill. Covers design systems, component patterns, accessibility, and framework-specific best practices. **13 stack guidelines:** `react` · `nextjs` · `vue` · `nuxtjs` · `svelte` · `astro` · `react-native` · `flutter` · `swiftui` · `jetpack-compose` · `shadcn` · `nuxt-ui` · `html-tailwind` --- ### Coming Soon | Skill | Description | | ------------ | ------------------------------------------------------------------------------- | | **Python** | Django, FastAPI, Flask, async patterns, type hints, testing, packaging | | **Database** | SQL optimization, schema design, migrations, indexing, PostgreSQL, MySQL, Redis | --- ## How It Works ``` Your question → AI coding assistant ↓ Reads skill workflow from CLAUDE.md / .cursorrules ↓ Runs: python3 .claude/skills/go/scripts/search.py "query" --domain pattern ↓ BM25 search engine ranks results from CSV databases ↓ AI applies the best patterns, packages, and architecture to your code ``` 1. **CSV Databases** — Curated, production-tested knowledge in structured CSV files 2. **BM25 Search Engine** — Fast, relevant search with zero Python dependencies 3. **Domain Auto-Detection** — Automatically routes queries to the most relevant domain 4. **Architecture Generator** — Combines multi-domain search with reasoning rules for new projects --- ## Manual Search Skills can also be used directly from the terminal: ```bash # Go — domain search python3 .claude/skills/go/scripts/search.py "worker pool" --domain concurrency python3 .claude/skills/go/scripts/search.py "error wrapping context" --domain error python3 .claude/skills/go/scripts/search.py "middleware auth" --stack web-gin # Go — architecture generator python3 .claude/skills/go/scripts/search.py "rest api postgres jwt" --arch-system -p "MyAPI" # Node.js python3 .claude/skills/nodejs/scripts/search.py "discriminated union" --domain typescript python3 .claude/skills/nodejs/scripts/search.py "loader action" --stack web-remix # Rust python3 .claude/skills/rust/scripts/search.py "typestate pattern" --domain pattern python3 .claude/skills/rust/scripts/search.py "middleware extractor" --stack web-axum # PHP python3 .claude/skills/php/scripts/search.py "prevent sql injection" --domain security python3 .claude/skills/php/scripts/search.py "eager load relationship" --stack laravel # Mobile python3 .claude/skills/mobile/scripts/search.py "mvvm bloc clean architecture" --domain pattern python3 .claude/skills/mobile/scripts/search.py "state management viewmodel" --stack flutter python3 .claude/skills/mobile/scripts/search.py "e-commerce cart checkout" --arch-system -p "ShopApp" # Auto-detect domain (no flag needed) python3 .claude/skills/go/scripts/search.py "goroutine channel pipeline" ``` --- ## Repository Structure ``` agentup/ ├── skills/ │ ├── go/ │ │ ├── data/ # 13 CSV knowledge databases │ │ │ ├── patterns.csv │ │ │ ├── packages.csv │ │ │ ├── concurrency.csv │ │ │ ├── ... │ │ │ └── stacks/ # 10 stack CSVs │ │ ├── scripts/ │ │ │ ├── search.py # CLI entry point + BM25 engine │ │ │ ├── core.py # Search core │ │ │ └── arch_system.py # Architecture generator │ │ └── templates/ │ ├── nodejs/ │ │ ├── data/ # 14 CSV knowledge databases │ │ └── scripts/ │ ├── rust/ │ │ ├── data/ # 14 CSV knowledge databases │ │ └── scripts/ │ ├── php/ │ │ ├── data/ # 21 CSV knowledge databases │ │ └── scripts/ │ ├── mobile/ │ │ ├── data/ # 22 CSV knowledge databases (12 domains + 9 stacks + reasoning) │ │ ├── scripts/ # BM25 search + architecture generator │ │ └── templates/ │ └── frontend/ │ ├── data/ │ └── scripts/ └── cli/ # npm CLI installer (@agentup/cli) └── src/ ├── index.ts └── commands/init.ts ``` --- ## Prerequisites - **Python 3.x** — for running skills (no external dependencies) - **Node.js 18+** — for the CLI installer only --- ## Contributing Contributions welcome! When adding or editing CSV entries: - All code examples must compile / run correctly - Package/crate names must exist on the official registry - CSV format: proper quoting, UTF-8, LF line endings - Follow the existing schema for the file you're editing --- ## License MIT