@agentskillkit/agent-skills 1.0.1 → 3.2.1

package/.agent/workflows/inspect.md

@@ -1,5 +1,6 @@
 ---
 description: Defense-in-depth code review. Multi-layer validation to prevent false completion claims.
+chain: security-audit
 ---
 
 # /inspect - Defense-in-Depth Review
@@ -14,6 +15,25 @@ Systematic code review with multi-layer validation. **Prevents false completion
 
 ---
 
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Pre-Review** | `assessor` | Evaluate review scope and risk |
+| **Conflict** | `critic` | Arbitrate build vs security trade-offs |
+| **Post-Review** | `learner` | Log common issues for faster detection |
+
+```
+Flow:
+assessor.evaluate(scope) → review layers
+       ↓
+issue conflict? → critic.arbitrate(security vs speed)
+       ↓
+complete → learner.log(patterns)
+```
+
+---
+
 ## Sub-commands
 
 ```
@@ -28,104 +48,119 @@ Systematic code review with multi-layer validation. **Prevents false completion
 ## 🔴 MANDATORY: 4-Layer Validation
 
 ### Layer 1: Compile/Build Check
+
 // turbo
+
 ```bash
 npm run build
 ```
 
-| Check | Required |
-|-------|----------|
-| TypeScript compiles | ✅ |
-| No lint errors | ✅ |
-| No warnings | ⚠️ |
+| Check               | Required |
+| ------------------- | -------- |
+| TypeScript compiles | ✅       |
+| No lint errors      | ✅       |
+| No warnings         | ⚠️       |
 
 ### Layer 2: Test Verification
+
 // turbo
+
 ```bash
 npm test
 ```
 
-| Check | Required |
-|-------|----------|
-| All tests pass | ✅ |
-| No skipped tests | ⚠️ |
-| Coverage maintained | ⚠️ |
+| Check               | Required |
+| ------------------- | -------- |
+| All tests pass      | ✅       |
+| No skipped tests    | ⚠️       |
+| Coverage maintained | ⚠️       |
 
 ### Layer 3: Security Check
+
 // turbo
+
 ```bash
-python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
+python .agent/skills/security-scanner/scripts/security_scan.py .
 ```
 
-| Check | Required |
-|-------|----------|
-| No hardcoded secrets | ✅ |
-| Input validation | ✅ |
-| SQL injection safe | ✅ |
-| XSS prevention | ✅ |
+| Check                | Required |
+| -------------------- | -------- |
+| No hardcoded secrets | ✅       |
+| Input validation     | ✅       |
+| SQL injection safe   | ✅       |
+| XSS prevention       | ✅       |
 
 ### Layer 4: Logic Review
 
-| Category | Questions |
-|----------|-----------|
-| **Correctness** | Does it solve the stated problem? |
-| **Edge Cases** | Null, empty, max values handled? |
-| **Error Handling** | All failure modes covered? |
-| **Performance** | N+1 queries? Memory leaks? |
+| Category            | Questions                            |
+| ------------------- | ------------------------------------ |
+| **Correctness**     | Does it solve the stated problem?    |
+| **Edge Cases**      | Null, empty, max values handled?     |
+| **Error Handling**  | All failure modes covered?           |
+| **Performance**     | N+1 queries? Memory leaks?           |
 | **Maintainability** | Clear naming? Single responsibility? |
 
 ---
 
 ## Output Format
 
-```markdown
+````markdown
 ## 🔍 Inspect: [Target]
 
 ### Layer 1: Build
+
 ✅ TypeScript: 0 errors
 ✅ Lint: 0 errors
 ⚠️ Warnings: 2 unused imports
 
 ### Layer 2: Tests
+
 ✅ Tests: 42 passed, 0 failed
 ✅ Coverage: 78% (target: 80%)
 
 ### Layer 3: Security
+
 ✅ No hardcoded secrets
 ✅ Input validation present
 ⚠️ Missing CSRF token on POST /api/user
 
 ### Layer 4: Logic Review
 
-| File | Issue | Severity |
-|------|-------|----------|
-| `user.ts:45` | Missing null check | High |
-| `api.ts:23` | No rate limiting | Medium |
-| `auth.ts:89` | Unused variable | Low |
+| File         | Issue              | Severity |
+| ------------ | ------------------ | -------- |
+| `user.ts:45` | Missing null check | High     |
+| `api.ts:23`  | No rate limiting   | Medium   |
+| `auth.ts:89` | Unused variable    | Low      |
 
 ### Summary
 
-| Layer | Status |
-|-------|--------|
-| Build | ✅ Pass |
-| Tests | ✅ Pass |
+| Layer    | Status       |
+| -------- | ------------ |
+| Build    | ✅ Pass      |
+| Tests    | ✅ Pass      |
 | Security | ⚠️ 1 warning |
-| Logic | ⚠️ 3 issues |
+| Logic    | ⚠️ 3 issues  |
 
 ### Verdict
+
 ⚠️ **NEEDS FIXES** before completion
 
 ### Required Actions
+
 1. Add null check in user.ts:45
 2. Add CSRF token to POST endpoints
 3. Consider rate limiting
 
 ### Evidence Required
+
 Before marking complete, run:
+
 ```bash
 npm run build && npm test
 ```
-```
+````
+
+````
 
 ---
 
@@ -141,7 +176,7 @@ npm run build && npm test
 ❌ WRONG:
 "I believe the code should work"
 "This should fix the issue"
-```
+````
 
 ---
 
@@ -175,13 +210,14 @@ graph LR
     style A fill:#06b6d4
 ```
 
-| After /inspect | Run | Purpose |
-|----------------|-----|---------|
-| Issues found | `/build` | Fix issues |
-| All clear | `/validate` | Run tests |
+| After /inspect | Run         | Purpose            |
+| -------------- | ----------- | ------------------ |
+| Issues found   | `/build`    | Fix issues         |
+| All clear      | `/validate` | Run tests          |
 | Security issue | `/diagnose` | Deep investigation |
 
 **Handoff to /build:**
+
 ```markdown
 Review complete. 3 issues found. Run /build to fix.
 ```

package/.agent/workflows/launch.md

@@ -1,5 +1,6 @@
 ---
 description: Zero-downtime release pipeline. Security scan, build verification, and health checks included.
+chain: deploy-production
 ---
 
 # /launch - Zero-Downtime Release
@@ -14,40 +15,65 @@ Production deployment with automated pre-flight checks, security scanning, and r
 
 ---
 
+## 🤖 Meta-Agents Integration
+
+| Phase | Agent | Action |
+| ----- | ----- | ------ |
+| **Pre-Deploy** | `assessor` | Evaluate deployment risk level |
+| **Pre-Deploy** | `recovery` | Save state via `state_manager.js` |
+| **On Failure** | `recovery` | Auto-rollback to saved state |
+| **Post-Deploy** | `learner` | Extract lessons from any issues |
+
+```
+Flow:
+assessor → recovery.save() → deploy → health check
+                                          ↓
+                               fail? → recovery.restore()
+                                          ↓
+                                      learner.log()
+```
+
+---
+
 ## 🔴 MANDATORY: Pre-Flight Checklist
 
 ### Gate 1: Code Quality
+
 // turbo
+
 ```bash
-python .agent/skills/lint-and-validate/scripts/lint_runner.py .
+python .agent/skills/code-quality/scripts/lint_runner.py .
 ```
 
-| Check | Command | Required |
-|-------|---------|----------|
-| TypeScript | `npx tsc --noEmit` | ✅ |
-| Linting | `npm run lint` | ✅ |
-| Tests | `npm test` | ✅ |
-| Build | `npm run build` | ✅ |
+| Check      | Command            | Required |
+| ---------- | ------------------ | -------- |
+| TypeScript | `npx tsc --noEmit` | ✅       |
+| Linting    | `npm run lint`     | ✅       |
+| Tests      | `npm test`         | ✅       |
+| Build      | `npm run build`    | ✅       |
 
 ### Gate 2: Security
+
 // turbo
+
 ```bash
-python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
+python .agent/skills/security-scanner/scripts/security_scan.py .
 ```
 
-| Check | Status |
-|-------|--------|
-| No hardcoded secrets | ✅ Required |
-| Dependencies audited | ✅ Required |
-| HTTPS configured | ✅ Required |
+| Check                     | Status      |
+| ------------------------- | ----------- |
+| No hardcoded secrets      | ✅ Required |
+| Dependencies audited      | ✅ Required |
+| HTTPS configured          | ✅ Required |
 | Environment variables set | ✅ Required |
 
 ### Gate 3: Performance
-| Check | Threshold |
-|-------|-----------|
-| Lighthouse Score | > 80 |
-| Bundle Size | < 500KB |
-| First Contentful Paint | < 2s |
+
+| Check                  | Threshold |
+| ---------------------- | --------- |
+| Lighthouse Score       | > 80      |
+| Bundle Size            | < 500KB   |
+| First Contentful Paint | < 2s      |
 
 ---
 
@@ -82,6 +108,112 @@ graph TD
 
 ---
 
+## 🔄 AUTO-ROLLBACK SYSTEM (FAANG+)
+
+### Phase 1: Pre-Deploy Checkpoint
+
+Before ANY deployment, create restore point:
+
+// turbo
+
+```bash
+# Create timestamped tag for rollback
+git tag pre-deploy-$(date +%Y%m%d-%H%M%S)
+
+# Save current commit hash
+echo $(git rev-parse HEAD) > .deploy-checkpoint
+```
+
+**What this does:**
+
+- Creates git tag `pre-deploy-20260128-211500`
+- Saves commit hash to `.deploy-checkpoint`
+
+---
+
+### Phase 2: Deploy with Monitoring
+
+```bash
+# Deploy command (platform-specific)
+$DEPLOY_COMMAND
+
+# Exit code check
+DEPLOY_EXIT_CODE=$?
+```
+
+---
+
+### Phase 3: Health Check (60s timeout)
+
+// turbo
+
+```bash
+# Health check script
+node .agent/scripts-js/health-check.js $DEPLOY_URL --timeout 60
+```
+
+**Health Check Criteria:**
+| Check | Endpoint | Expected |
+|-------|----------|----------|
+| API Status | `GET /api/health` | 200 OK |
+| Database | `GET /api/health/db` | 200 OK |
+| Response Time | - | < 2000ms |
+
+---
+
+### Phase 4: Auto-Rollback on Failure
+
+**If health check fails:**
+
+```bash
+# Read checkpoint
+CHECKPOINT=$(cat .deploy-checkpoint)
+
+# Revert to checkpoint
+git revert --no-commit HEAD..${CHECKPOINT}
+git commit -m "auto-rollback: health check failed at $(date)"
+
+# Re-deploy previous version
+$DEPLOY_COMMAND
+```
+
+**Notification:**
+
+```markdown
+## ⚠️ AUTO-ROLLBACK TRIGGERED
+
+| Metric      | Value               |
+| ----------- | ------------------- |
+| Time        | 2026-01-28 21:15:00 |
+| Reason      | Health check failed |
+| Reverted to | v2.0.5 (abc123)     |
+| Duration    | 23 seconds          |
+
+### What Failed
+
+- API responded with 500
+- Database connection timeout
+
+### Next Steps
+
+1. Check logs: `$PLATFORM logs --tail 100`
+2. Run `/diagnose` to find root cause
+3. Fix and try `/launch` again
+```
+
+---
+
+### Rollback Commands
+
+| Command                        | Action                             |
+| ------------------------------ | ---------------------------------- |
+| `/launch rollback`             | Rollback to last checkpoint        |
+| `/launch rollback --to v2.0.3` | Rollback to specific version       |
+| `/launch rollback --list`      | List available rollback points     |
+| `/launch rollback --dry-run`   | Preview rollback without executing |
+
+---
+
 ## Output Format
 
 ### Successful Launch
@@ -90,34 +222,40 @@ graph TD
 ## 🚀 Launch Complete
 
 ### Summary
-| Metric | Value |
-|--------|-------|
-| Version | v2.1.0 |
+
+| Metric      | Value      |
+| ----------- | ---------- |
+| Version     | v2.1.0     |
 | Environment | Production |
-| Duration | 47 seconds |
-| Platform | Vercel |
+| Duration    | 47 seconds |
+| Platform    | Vercel     |
 
 ### Pre-Flight Results
+
 ✅ TypeScript: No errors
 ✅ Tests: 42/42 passed
 ✅ Security: No vulnerabilities
 ✅ Build: Success (234KB)
 
 ### URLs
+
 🌐 **Production:** https://app.example.com
 🔧 **Dashboard:** https://vercel.com/project
 
 ### Health Check
+
 ✅ API responding (200 OK)
 ✅ Database connected
 ✅ CDN cached
 
 ### What Changed
+
 - Added user profile feature
 - Fixed authentication bug
 - Updated dependencies
 
 ### Rollback Available
+
 Previous version (v2.0.5) saved.
 Run `/launch rollback` if needed.
 ```
@@ -128,22 +266,26 @@ Run `/launch rollback` if needed.
 ## ❌ Launch Aborted
 
 ### Pre-Flight Failed
-| Check | Result |
-|-------|--------|
-| TypeScript | ❌ 3 errors |
-| Tests | ✅ Pass |
-| Security | ⚠️ 1 warning |
+
+| Check      | Result       |
+| ---------- | ------------ |
+| TypeScript | ❌ 3 errors  |
+| Tests      | ✅ Pass      |
+| Security   | ⚠️ 1 warning |
 
 ### Blockers
+
 1. **TypeScript Error** in `src/api/user.ts:42`
    - `Property 'id' does not exist on type 'null'`
 
 ### Resolution
+
 1. Fix TypeScript error
 2. Run `npm run build` locally
 3. Try `/launch` again
 
 ### No Changes Made
+
 Production is still running v2.0.5.
 ```
 
@@ -151,13 +293,13 @@ Production is still running v2.0.5.
 
 ## Platform Configuration
 
-| Platform | Command | Auto-detected |
-|----------|---------|---------------|
-| Vercel | `vercel --prod` | Next.js, Vite |
-| Railway | `railway up` | Dockerfile |
-| Fly.io | `fly deploy` | fly.toml |
-| Netlify | `netlify deploy --prod` | Static sites |
-| AWS | `sam deploy` | SAM template |
+| Platform | Command                 | Auto-detected |
+| -------- | ----------------------- | ------------- |
+| Vercel   | `vercel --prod`         | Next.js, Vite |
+| Railway  | `railway up`            | Dockerfile    |
+| Fly.io   | `fly deploy`            | fly.toml      |
+| Netlify  | `netlify deploy --prod` | Static sites  |
+| AWS      | `sam deploy`            | SAM template  |
 
 ---
 
@@ -193,13 +335,14 @@ graph LR
     style B fill:#10b981
 ```
 
-| After /launch | Run | Purpose |
-|---------------|-----|---------|
-| Deploy success | `/chronicle` | Generate docs |
-| Deploy fail | `/diagnose` | Debug issue |
-| Need rollback | `/launch rollback` | Revert |
+| After /launch  | Run                | Purpose       |
+| -------------- | ------------------ | ------------- |
+| Deploy success | `/chronicle`       | Generate docs |
+| Deploy fail    | `/diagnose`        | Debug issue   |
+| Need rollback  | `/launch rollback` | Revert        |
 
 **Handoff to /chronicle:**
+
 ```markdown
 🚀 Deployed to production!
 URL: https://app.example.com

package/.agent/workflows/mobile.md

@@ -0,0 +1,106 @@
+---
+description: Mobile app development workflow with React Native/Flutter/Native. Full lifecycle from requirements to app store.
+---
+
+# Mobile Development Workflow
+
+> **This workflow orchestrates mobile app development from concept to app store submission.**
+
+## Phase 1: Requirements Clarification
+
+1. **Ask critical questions BEFORE any design:**
+   - Platform: iOS, Android, or both?
+   - Framework: React Native, Flutter, or native?
+   - Navigation: Tabs, drawer, or stack-based?
+   - Offline: Does this need to work offline?
+   - Devices: Phone only or tablet too?
+
+2. **Calculate MFRI (Mobile Feasibility Risk Index):**
+   - Read `mobile-design/SKILL.md` → Apply MFRI formula
+   - If MFRI < 3 → Redesign before implementation
+
+---
+
+## Phase 2: Design & Architecture
+
+3. **Load mobile-design skill:**
+   ```
+   Read: .agent/skills/mobile-design/SKILL.md
+   Then read platform-specific files based on target
+   ```
+
+4. **Apply platform conventions:**
+   - iOS: SF Pro font, 44pt touch targets, edge swipe back
+   - Android: Roboto font, 48dp touch targets, system back button
+
+5. **Create component architecture:**
+   - Follow mobile-first principles
+   - Ensure all touch targets ≥ 44-48px
+
+---
+
+## Phase 3: Implementation
+
+6. **Load mobile-developer skill:**
+   ```
+   Read: .agent/skills/mobile-developer/SKILL.md
+   ```
+
+7. **Initialize project:**
+   - React Native: `npx create-expo-app@latest ./`
+   - Flutter: `flutter create .`
+   - Native iOS: SwiftUI project
+   - Native Android: Kotlin + Compose project
+
+8. **Apply performance patterns:**
+   - FlatList/FlashList for lists (NEVER ScrollView)
+   - React.memo + useCallback for all components
+   - const widgets in Flutter
+
+---
+
+## Phase 4: Security Implementation
+
+9. **Load mobile-security-coder skill:**
+   ```
+   Read: .agent/skills/mobile-security-coder/SKILL.md
+   ```
+
+10. **Apply security checklist:**
+    - [ ] Secure storage (Keychain/Keystore)
+    - [ ] Certificate pinning
+    - [ ] Biometric authentication
+    - [ ] No sensitive data in logs
+
+---
+
+## Phase 5: Testing & Verification
+
+11. **Run mobile audit script:**
+    ```bash
+    python .agent/skills/mobile-design/scripts/mobile_audit.py <project_path>
+    ```
+
+12. **Test checklist:**
+    - [ ] Touch targets ≥ 44-48px
+    - [ ] Works offline (if required)
+    - [ ] Tested on low-end devices
+    - [ ] Accessibility labels present
+
+---
+
+## Phase 6: App Store Preparation
+
+13. **iOS App Store:**
+    - Privacy labels configured
+    - Screenshots for all device sizes
+    - App Transport Security configured
+
+14. **Google Play Store:**
+    - Target API = current year's SDK
+    - 64-bit build
+    - App bundle format
+
+---
+
+> **Remember:** Mobile users are impatient, interrupted, using imprecise fingers on small screens. Design for the WORST conditions.