@agentskillkit/agent-skills 1.0.1

package/.agent/workflows/boost.md

@@ -0,0 +1,163 @@
+---
+description: Feature enhancer for existing apps. Iterative upgrades with dependency awareness.
+---
+
+# /boost - Feature Enhancer
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Add features or upgrades to existing applications. **Analyzes current architecture before making changes to prevent conflicts.**
+
+---
+
+## 🔴 MANDATORY: Impact Assessment
+
+Before ANY change:
+
+### Step 1: Project Analysis
+// turbo
+```bash
+python .agent/scripts/session_manager.py info
+```
+
+### Step 2: Security Check
+// turbo
+```bash
+python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
+```
+
+### Step 3: Dependency Map
+```
+Identify:
+□ Direct dependencies (what this file imports)
+□ Reverse dependencies (what imports this file)
+□ External packages affected
+□ Database schema changes needed
+```
+
+---
+
+## Impact Classification
+
+| Change Size | Criteria | Action Required |
+|-------------|----------|-----------------|
+| **Small** | 1-3 files, no deps | Proceed directly |
+| **Medium** | 4-10 files, minor deps | Show plan, get approval |
+| **Large** | 10+ files, breaking changes | Create PLAN.md first |
+
+---
+
+## Output Format
+
+```markdown
+## 🚀 Boost: [Feature Name]
+
+### Impact Assessment
+
+| Metric | Value |
+|--------|-------|
+| Files Created | 5 |
+| Files Modified | 3 |
+| Tests Affected | 2 |
+| Breaking Changes | None |
+
+### Dependency Analysis
+
+```mermaid
+graph LR
+    A[New Feature] --> B[userService]
+    A --> C[authMiddleware]
+    B --> D[database]
+    C --> E[jwt]
+```
+
+### Changes Required
+
+| File | Change | Risk |
+|------|--------|------|
+| `src/services/user.ts` | Add method | Low |
+| `src/routes/api.ts` | New endpoint | Low |
+| `prisma/schema.prisma` | Add field | Medium |
+
+### Approval Required?
+⚠️ **Medium change** - 8 files affected
+
+Proceed? (y/n)
+```
+
+---
+
+## After Approval
+
+```markdown
+## ✅ Boost Complete
+
+### Summary
+| Metric | Value |
+|--------|-------|
+| Files Created | 5 |
+| Files Modified | 3 |
+| Time | 4m 32s |
+
+### Changes Made
+1. ✅ Added `darkMode` field to user preferences
+2. ✅ Created toggle component
+3. ✅ Updated CSS variables
+4. ✅ Added localStorage persistence
+
+### Tests
+✅ 3 new tests added
+✅ All tests passing
+
+### Preview
+Hot reload applied - refresh to see changes.
+```
+
+---
+
+## Examples
+
+```
+/boost add dark mode toggle
+/boost integrate Stripe payments
+/boost add user notifications
+/boost make mobile responsive
+/boost add search with filters
+/boost upgrade to React 19
+```
+
+---
+
+## Key Principles
+
+1. **Analyze before changing** - understand impact
+2. **Preserve existing** - don't break what works
+3. **Incremental changes** - commit frequently
+4. **Test affected code** - don't skip tests
+5. **Document changes** - update README if needed
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/boost"] --> B["/validate"]
+    B --> C["/launch"]
+    style A fill:#f59e0b
+```
+
+| After /boost | Run | Purpose |
+|--------------|-----|---------|
+| Feature added | `/validate` | Test changes |
+| Ready to deploy | `/launch` | Deploy |
+| Found issues | `/diagnose` | Debug |
+
+**Handoff to /validate:**
+```markdown
+Feature added. Run /validate to test changes.
+```

package/.agent/workflows/build.md

@@ -0,0 +1,192 @@
+---
+description: Full-stack application factory. From idea to deployed app with multi-agent coordination.
+---
+
+# /build - Application Factory
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Ship production-ready applications from natural language descriptions. **Coordinates 4+ specialist agents with automated verification.**
+
+---
+
+## 🔴 MANDATORY: Build Pipeline
+
+### Phase 1: Requirements Discovery
+// turbo
+Ask these questions if not answered:
+```
+1. What TYPE of app? (web/mobile/api/cli)
+2. Who are the USERS? (consumers/business/developers)
+3. What are the CORE FEATURES? (list 3-5 must-haves)
+4. What STACK preferences? (or let me choose)
+5. What is the TIMELINE? (MVP/full product)
+```
+
+### Phase 2: Tech Stack Selection
+
+**AI-Powered Stack Recommendation:**
+
+| App Type | Recommended Stack | Agents Invoked |
+|----------|-------------------|----------------|
+| **Web SaaS** | Next.js + Prisma + PostgreSQL | frontend, backend, database |
+| **E-commerce** | Next.js + Stripe + Supabase | frontend, backend, security |
+| **Mobile** | React Native + Expo + Firebase | mobile, backend, test |
+| **API** | Hono + Prisma + Railway | backend, database, devops |
+| **Dashboard** | Next.js + Tremor + Chart.js | frontend, backend |
+
+### Phase 3: Project Scaffolding
+// turbo
+```bash
+# Auto-detect and scaffold
+python .agent/scripts/session_manager.py create --name "$PROJECT_NAME" --stack "$STACK"
+```
+
+### Phase 4: Multi-Agent Build
+
+```mermaid
+graph TD
+    A[/build request] --> B[project-planner]
+    B --> C[Create PLAN.md]
+    C --> D{User Approval?}
+    D -->|Yes| E[Parallel Build]
+    D -->|No| B
+    E --> F[database-architect]
+    E --> G[backend-specialist]
+    E --> H[frontend-specialist]
+    F --> I[Schema + Migrations]
+    G --> J[API Endpoints]
+    H --> K[UI Components]
+    I --> L[Integration]
+    J --> L
+    K --> L
+    L --> M[test-engineer]
+    M --> N[Preview Deploy]
+```
+
+### Phase 5: Preview & Iterate
+// turbo
+```bash
+python .agent/scripts/auto_preview.py start
+```
+
+---
+
+## Output Format
+
+```markdown
+## 🏗️ Building: [App Name]
+
+### Stack Decision
+| Layer | Choice | Reason |
+|-------|--------|--------|
+| Frontend | Next.js 15 | SSR, App Router, Vercel deploy |
+| Backend | Hono + Prisma | Type-safe, edge-ready |
+| Database | PostgreSQL | Relational, Supabase hosting |
+| Auth | Clerk | Fast integration, social login |
+| Styling | Tailwind + shadcn/ui | Rapid UI development |
+
+### Agent Coordination
+
+| Agent | Task | Status |
+|-------|------|--------|
+| `database-architect` | Schema design | ✅ Complete |
+| `backend-specialist` | API routes | 🔄 In progress |
+| `frontend-specialist` | UI components | ⏳ Waiting |
+| `test-engineer` | E2E tests | ⏳ Waiting |
+
+### Files Created
+```
+src/
+├── app/
+│   ├── page.tsx
+│   ├── layout.tsx
+│   └── api/
+├── components/
+├── lib/
+├── prisma/
+│   └── schema.prisma
+└── tests/
+```
+
+### Preview
+🌐 **URL:** http://localhost:3000
+📊 **Status:** Running
+
+### Next Steps
+- [ ] Review the code
+- [ ] Test core features
+- [ ] Request changes or `/launch` to deploy
+```
+
+---
+
+## Examples
+
+```
+/build SaaS dashboard with user analytics
+/build e-commerce app with Stripe payments
+/build blog with MDX and CMS
+/build real-time chat app
+/build portfolio with project gallery
+/build REST API for mobile app
+```
+
+---
+
+## Smart Defaults
+
+If user doesn't specify, use these:
+
+| Aspect | Default |
+|--------|---------|
+| Framework | Next.js 15 |
+| Styling | Tailwind + shadcn/ui |
+| Database | PostgreSQL (Supabase) |
+| Auth | Clerk |
+| Deployment | Vercel |
+| Testing | Vitest + Playwright |
+
+---
+
+## Quality Gates
+
+Before marking complete, verify:
+
+- [ ] All files compile without errors
+- [ ] Database schema is valid
+- [ ] API endpoints respond correctly
+- [ ] UI renders without errors
+- [ ] Preview server is running
+- [ ] User can test the app
+
+**NEVER mark complete without a working preview.**
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/architect"] --> B["/build"]
+    B --> C["/validate"]
+    C --> D["/launch"]
+    style B fill:#10b981
+```
+
+| After /build | Run | Purpose |
+|--------------|-----|---------|
+| Build complete | `/validate` | Run tests |
+| Needs testing | `/stage` | Start preview server |
+| Ready to deploy | `/launch` | Deploy to production |
+| Found bugs | `/diagnose` | Debug issues |
+
+**Handoff to /validate:**
+```markdown
+Build complete. Preview running at http://localhost:3000
+Run /validate to generate and execute tests.
+```

package/.agent/workflows/chronicle.md

@@ -0,0 +1,172 @@
+---
+description: Auto-documentation engine. README, API specs, and inline comments with zero effort.
+---
+
+# /chronicle - Documentation Engine
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Generate comprehensive documentation automatically. **Analyzes code structure and produces README, API specs, and inline comments.**
+
+---
+
+## Sub-commands
+
+```
+/chronicle              - Full documentation suite
+/chronicle readme       - Generate/update README.md
+/chronicle api          - Generate API documentation
+/chronicle inline       - Add inline code comments
+/chronicle [file-path]  - Document specific file
+/chronicle changelog    - Generate CHANGELOG.md
+```
+
+---
+
+## 🔴 MANDATORY: Documentation Standards
+
+### README.md Structure
+
+```markdown
+# Project Name
+
+> One-line description
+
+## Features
+- Feature 1
+- Feature 2
+
+## Quick Start
+
+### Prerequisites
+- Node.js 18+
+- PostgreSQL
+
+### Installation
+```bash
+npm install
+npm run dev
+```
+
+## API Reference
+[Link to API docs]
+
+## Contributing
+[CONTRIBUTING.md]
+
+## License
+MIT
+```
+
+### API Documentation
+
+| Element | Format |
+|---------|--------|
+| Endpoints | OpenAPI 3.0 |
+| Types | TypeScript interfaces |
+| Examples | cURL + JavaScript |
+| Errors | Standard error codes |
+
+### Inline Comments
+
+```typescript
+/**
+ * Creates a new user account with email verification.
+ * 
+ * @param data - User registration data
+ * @param data.email - Valid email address
+ * @param data.password - Min 8 chars, 1 uppercase, 1 number
+ * @returns Newly created user with verification token
+ * @throws {ValidationError} If email is invalid
+ * @throws {ConflictError} If email already exists
+ * @example
+ * const user = await createUser({
+ *   email: 'user@example.com',
+ *   password: 'SecurePass123'
+ * });
+ */
+export async function createUser(data: CreateUserInput): Promise<User> {
+  // Implementation
+}
+```
+
+---
+
+## Output Format
+
+```markdown
+## 📚 Chronicle Complete
+
+### Generated Files
+
+| File | Type | Lines |
+|------|------|-------|
+| README.md | Markdown | 89 |
+| docs/API.md | OpenAPI | 234 |
+| CHANGELOG.md | Changelog | 45 |
+
+### Documentation Coverage
+
+| Metric | Current | Target |
+|--------|---------|--------|
+| Functions Documented | 45/52 | 100% |
+| API Endpoints | 12/12 | ✅ |
+| README Sections | 8/8 | ✅ |
+
+### Files Updated
+- ✅ README.md - Added quick start
+- ✅ docs/API.md - Added auth endpoints
+- ✅ src/services/user.ts - Added JSDoc
+
+### Next Steps
+- [ ] Review generated docs
+- [ ] Add usage examples
+- [ ] Update CHANGELOG
+```
+
+---
+
+## Examples
+
+```
+/chronicle
+/chronicle readme
+/chronicle api
+/chronicle src/services/auth.ts
+/chronicle changelog --since v1.0.0
+```
+
+---
+
+## Key Principles
+
+1. **Code as source** - extract docs from code
+2. **Keep updated** - regenerate on changes
+3. **Examples matter** - always include usage
+4. **Types are docs** - use TypeScript annotations
+5. **Minimal but complete** - no fluff
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/launch"] --> B["/chronicle"]
+    B --> C["📚 Docs"]
+    style B fill:#8b5cf6
+```
+
+| After /chronicle | Run | Purpose |
+|------------------|-----|---------|
+| Docs generated | Review | Verify accuracy |
+| Need more | `/chronicle api` | Generate API docs |
+
+**Handoff:**
+```markdown
+Documentation generated. README.md and API docs updated.
+```

package/.agent/workflows/diagnose.md

@@ -0,0 +1,207 @@
+---
+description: Root cause detective. Hypothesis-driven debugging with evidence-based verification.
+---
+
+# /diagnose - Root Cause Detective
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Systematic debugging using scientific method. **Form hypotheses, gather evidence, eliminate possibilities until root cause is found.**
+
+---
+
+## 🔴 MANDATORY: 5-Phase Investigation
+
+### Phase 1: Symptom Collection
+```
+GATHER:
+□ Exact error message (copy/paste)
+□ When did it start?
+□ What changed recently?
+□ Reproduction steps
+□ Expected vs actual behavior
+□ Environment (dev/staging/prod)
+```
+
+### Phase 2: Hypothesis Formation
+Generate 3+ ranked hypotheses:
+
+| # | Hypothesis | Likelihood | Test Method |
+|---|------------|------------|-------------|
+| 1 | [Most likely cause] | 70% | [How to verify] |
+| 2 | [Second possibility] | 20% | [How to verify] |
+| 3 | [Edge case] | 10% | [How to verify] |
+
+### Phase 3: Evidence Gathering
+// turbo
+```bash
+# Run code analysis
+python .agent/scripts/checklist.py .
+
+# Check for security issues
+python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
+```
+
+### Phase 4: Systematic Elimination
+
+For each hypothesis:
+1. Define the TEST
+2. Predict the OUTCOME if hypothesis is true
+3. Run the test
+4. Record ACTUAL result
+5. ✅ Confirmed or ❌ Eliminated
+
+### Phase 5: Fix + Prevention
+
+```markdown
+## Root Cause Confirmed
+[Clear explanation]
+
+## Fix Applied
+[Code changes with before/after]
+
+## Prevention Measures
+- [ ] Add test case for this scenario
+- [ ] Add input validation
+- [ ] Update documentation
+- [ ] Add monitoring/alert
+```
+
+---
+
+## Output Format
+
+```markdown
+## 🔍 Diagnosis: [Issue Title]
+
+### Symptom
+> [User's description of the problem]
+
+### Environment
+| Aspect | Value |
+|--------|-------|
+| File | `src/services/auth.ts` |
+| Line | 42 |
+| Environment | Development |
+| Last Working | 2 commits ago |
+
+---
+
+### Hypotheses
+
+| # | Hypothesis | Likelihood | Status |
+|---|------------|------------|--------|
+| 1 | Null reference in user object | 70% | ✅ CONFIRMED |
+| 2 | API timeout | 20% | ❌ Eliminated |
+| 3 | Cache stale data | 10% | ⏳ Not tested |
+
+---
+
+### Investigation Log
+
+**Testing H1: Null reference**
+- Test: Add console.log before line 42
+- Prediction: user.id will be undefined
+- Result: ✅ user was null when not logged in
+- Verdict: **ROOT CAUSE FOUND**
+
+---
+
+### Root Cause
+🎯 **user object is null when accessing protected route without auth**
+
+The `getUser()` function returns null for unauthenticated requests, but the code assumes it always returns a user object.
+
+---
+
+### Fix
+
+```typescript
+// ❌ Before
+const userId = user.id;
+
+// ✅ After  
+if (!user) {
+  throw new AuthError('User not authenticated');
+}
+const userId = user.id;
+```
+
+---
+
+### Prevention
+
+- [x] Added null check before accessing user properties
+- [ ] Add auth middleware to protect route
+- [ ] Add test for unauthenticated access
+- [ ] Add TypeScript strict null checks
+
+---
+
+### Verification
+// turbo
+Run tests to confirm fix:
+```bash
+npm test -- --grep "auth"
+```
+```
+
+---
+
+## Examples
+
+```
+/diagnose login returns 401 even with correct credentials
+/diagnose form data not saving to database
+/diagnose page crashes on mobile Safari
+/diagnose API response is 10x slower since yesterday
+/diagnose deployment fails on Vercel
+```
+
+---
+
+## Key Principles
+
+1. **Never guess** - hypothesize and test
+2. **Most likely first** - test highest probability hypothesis first
+3. **Log everything** - document investigation for future reference
+4. **Fix + Prevent** - don't just patch, prevent recurrence
+5. **Verify fix** - always confirm the fix works
+
+---
+
+## Common Root Causes Checklist
+
+| Category | Things to Check |
+|----------|-----------------|
+| **Data** | Null values, wrong types, stale cache |
+| **Auth** | Expired tokens, missing headers, CORS |
+| **Network** | Timeouts, DNS, SSL certificates |
+| **Code** | Recent changes, missing await, wrong imports |
+| **Environment** | Env vars, versions, dependencies |
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/diagnose"] --> B["/validate"]
+    B --> C["/launch"]
+    style A fill:#ef4444
+```
+
+| After /diagnose | Run | Purpose |
+|-----------------|-----|---------|
+| Bug fixed | `/validate` | Verify fix |
+| Need tests | `/validate` | Add test case |
+| Ready | `/launch` | Deploy fix |
+
+**Handoff to /validate:**
+```markdown
+Bug fixed. Run /validate to verify the fix works.
+```