@agentskillkit/agent-skills 1.0.1

package/.agent/workflows/forge.md

@@ -0,0 +1,123 @@
+---
+description: Skill smithy. Create, validate, and package new capabilities using progressive disclosure patterns.
+---
+
+# /forge - Skill Creation Studio
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Create, validate, and package Agent Skills following best practices. **Uses progressive disclosure architecture for optimal token management.**
+
+---
+
+## Sub-commands
+
+```
+/forge create <skill-name>    - Create new skill
+/forge validate <skill-path>  - Validate existing skill
+/forge package <skill-path>   - Package for distribution
+```
+
+---
+
+## Workflow
+
+### 1. Create New Skill
+// turbo
+```bash
+python .agent/skills/skill-creator/scripts/init_skill.py <skill-name> --path .agent/skills/
+```
+
+This creates:
+```
+<skill-name>/
+├── SKILL.md        # Entry point (<200 lines)
+├── references/     # Detailed docs (on-demand)
+├── scripts/        # Executable code
+└── assets/         # Templates, images
+```
+
+### 2. Follow 200-Line Rule
+
+**SKILL.md must be <200 lines.** Split into references:
+
+| Section | Purpose | Size |
+|---------|---------|------|
+| Entry point | Navigation map + Quick reference | <200 lines |
+| References | Detailed documentation | Unlimited |
+| Scripts | Executable code | As needed |
+
+### 3. Validate Skill
+// turbo
+```bash
+python .agent/skills/skill-creator/scripts/quick_validate.py .agent/skills/<skill-name>
+```
+
+Checks:
+- ✅ YAML frontmatter (name, description required)
+- ✅ File size limits
+- ✅ Directory structure
+- ✅ Reference links
+
+### 4. Package for Distribution
+// turbo
+```bash
+python .agent/skills/skill-creator/scripts/package_skill.py .agent/skills/<skill-name>
+```
+
+Creates a distributable zip file.
+
+---
+
+## Progressive Disclosure Architecture
+
+```mermaid
+graph TD
+    A[Skill Activated] --> B{Tier 1: Metadata}
+    B --> C[~100 words - Always loaded]
+    C --> D{Tier 2: SKILL.md}
+    D --> E[<200 lines - On activation]
+    E --> F{Tier 3: References}
+    F --> G[Unlimited - On-demand]
+```
+
+---
+
+## Examples
+
+```
+/forge create api-patterns
+/forge validate .agent/skills/my-skill
+/forge package .agent/skills/my-skill
+```
+
+---
+
+## Related Skills
+
+- `skill-creator` - Full skill creation guide
+- `context-engineering` - Context optimization principles
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/forge"] --> B["🎯 Skill Created"]
+    style A fill:#a855f7
+```
+
+| After /forge | Action |
+|--------------|--------|
+| Skill created | Test with `/autopilot` |
+| Need docs | `/chronicle` |
+
+**Handoff:**
+```markdown
+Skill created at .agent/skills/<name>/
+```

package/.agent/workflows/inspect.md

@@ -0,0 +1,187 @@
+---
+description: Defense-in-depth code review. Multi-layer validation to prevent false completion claims.
+---
+
+# /inspect - Defense-in-Depth Review
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Systematic code review with multi-layer validation. **Prevents false completion claims with evidence-based verification.**
+
+---
+
+## Sub-commands
+
+```
+/inspect              - Review current changes
+/inspect [file-path]  - Review specific file
+/inspect --pr         - PR-style review
+/inspect --security   - Security-focused review
+```
+
+---
+
+## 🔴 MANDATORY: 4-Layer Validation
+
+### Layer 1: Compile/Build Check
+// turbo
+```bash
+npm run build
+```
+
+| 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 | ⚠️ |
+
+### Layer 3: Security Check
+// turbo
+```bash
+python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
+```
+
+| 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? |
+| **Maintainability** | Clear naming? Single responsibility? |
+
+---
+
+## Output Format
+
+```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 |
+
+### Summary
+
+| Layer | Status |
+|-------|--------|
+| Build | ✅ Pass |
+| Tests | ✅ Pass |
+| Security | ⚠️ 1 warning |
+| 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
+```
+```
+
+---
+
+## Evidence-Based Completion
+
+**NEVER claim completion without proof:**
+
+```markdown
+✅ CORRECT:
+"Build passed: `npm run build` completed in 3.2s"
+"Tests: 42/42 passed (npm test output attached)"
+
+❌ WRONG:
+"I believe the code should work"
+"This should fix the issue"
+```
+
+---
+
+## Examples
+
+```
+/inspect
+/inspect src/services/auth.ts
+/inspect --pr
+/inspect --security
+```
+
+---
+
+## Key Principles
+
+1. **Evidence over belief** - prove it works
+2. **Every layer matters** - don't skip checks
+3. **Security first** - scan before completion
+4. **Fix before claiming** - no "should work"
+5. **Document issues** - clear action items
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/inspect"] --> B["/build"]
+    B --> C["/validate"]
+    style A fill:#06b6d4
+```
+
+| 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

@@ -0,0 +1,208 @@
+---
+description: Zero-downtime release pipeline. Security scan, build verification, and health checks included.
+---
+
+# /launch - Zero-Downtime Release
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Production deployment with automated pre-flight checks, security scanning, and rollback capability. **Never deploy without verification.**
+
+---
+
+## 🔴 MANDATORY: Pre-Flight Checklist
+
+### Gate 1: Code Quality
+// turbo
+```bash
+python .agent/skills/lint-and-validate/scripts/lint_runner.py .
+```
+
+| 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 .
+```
+
+| 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 |
+
+---
+
+## Sub-commands
+
+```
+/launch           - Interactive deployment wizard
+/launch check     - Run pre-flight checks only
+/launch preview   - Deploy to staging/preview
+/launch ship      - Deploy to production
+/launch rollback  - Rollback to previous version
+```
+
+---
+
+## Deployment Pipeline
+
+```mermaid
+graph TD
+    A[/launch] --> B{Pre-flight checks}
+    B -->|Fail| C[Fix issues]
+    C --> B
+    B -->|Pass| D[Build application]
+    D --> E{Build success?}
+    E -->|No| C
+    E -->|Yes| F[Deploy to platform]
+    F --> G[Health check]
+    G -->|Fail| H[Auto-rollback]
+    G -->|Pass| I[✅ Live]
+    H --> J[Alert team]
+```
+
+---
+
+## Output Format
+
+### Successful Launch
+
+```markdown
+## 🚀 Launch Complete
+
+### Summary
+| Metric | Value |
+|--------|-------|
+| Version | v2.1.0 |
+| Environment | Production |
+| 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.
+```
+
+### Failed Launch
+
+```markdown
+## ❌ Launch Aborted
+
+### Pre-Flight Failed
+| 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.
+```
+
+---
+
+## 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 |
+
+---
+
+## Examples
+
+```
+/launch
+/launch check
+/launch preview
+/launch ship --skip-tests
+/launch rollback
+/launch rollback --to v2.0.3
+```
+
+---
+
+## Key Principles
+
+1. **Never skip security** - always run vulnerability scan
+2. **Rollback-first** - keep previous version ready
+3. **Health check** - verify after deploy, not just during
+4. **Notify on failure** - alert immediately if issues
+5. **Document changes** - update changelog automatically
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/validate"] --> B["/launch"]
+    B --> C["✅ Production"]
+    style B fill:#10b981
+```
+
+| 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
+Version: v2.1.0
+Run /chronicle to generate updated documentation.
+```

package/.agent/workflows/pulse.md

@@ -0,0 +1,115 @@
+---
+description: Project health dashboard. Agent status, file stats, and real-time progress tracking.
+---
+
+# /pulse - Project Health Dashboard
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Display real-time project status including agent progress, file statistics, and preview health. **Single command for complete project visibility.**
+
+---
+
+## What It Shows
+
+| Section | Information |
+|---------|-------------|
+| **Project Info** | Name, path, tech stack, features |
+| **Agent Board** | Running agents, completed tasks, pending work |
+| **File Stats** | Created/modified file counts |
+| **Preview** | Server URL, health status |
+
+---
+
+## Technical
+
+### Get Status
+// turbo
+```bash
+python .agent/scripts/session_manager.py status
+```
+
+### Check Preview
+// turbo
+```bash
+python .agent/scripts/auto_preview.py status
+```
+
+---
+
+## Example Output
+
+```markdown
+=== Project Status ===
+
+📁 Project: my-ecommerce
+📂 Path: C:/projects/my-ecommerce
+🏷️ Type: nextjs-ecommerce
+📊 Status: active
+
+🔧 Tech Stack:
+   Framework: next.js
+   Database: postgresql
+   Auth: clerk
+   Payment: stripe
+
+✅ Features (5):
+   • product-listing
+   • cart
+   • checkout
+   • user-auth
+   • order-history
+
+⏳ Pending (2):
+   • admin-panel
+   • email-notifications
+
+📄 Files: 73 created, 12 modified
+
+=== Agent Status ===
+
+| Agent | Task | Status |
+|-------|------|--------|
+| database-architect | Schema | ✅ Complete |
+| backend-specialist | API | ✅ Complete |
+| frontend-specialist | UI | 🔄 60% |
+| test-engineer | Tests | ⏳ Waiting |
+
+=== Preview ===
+
+🌐 URL: http://localhost:3000
+💚 Health: OK
+```
+
+---
+
+## Examples
+
+```
+/pulse
+```
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/pulse"] --> B["📊 Status"]
+    style A fill:#22c55e
+```
+
+| After /pulse | Run | Purpose |
+|--------------|-----|---------|
+| See issues | `/diagnose` | Debug |
+| Ready to test | `/validate` | Run tests |
+| Ready to deploy | `/launch` | Deploy |
+
+**Handoff:**
+```markdown
+Status: 5 features complete, preview running at localhost:3000
+```