Add Salesforce (sf cli tool) skill

README.md

@@ -1,7 +1,7 @@
 # Atomic Skills for Claude Code
 
 [![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-blue)](https://docs.claude.com/en/docs/claude-code/plugins)
-[![Skills](https://img.shields.io/badge/Skills-447-green)](skills/)
+[![Skills](https://img.shields.io/badge/Skills-454-green)](skills/)
 [![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
 
 **Context-efficient development knowledge via progressive skill discovery**
@@ -42,7 +42,7 @@ This creates an challenging tradeoff between comprehensive coverage and context
 
 ## The Solution: Atomic Skills + Progressive Discovery
 
-### Atomic Skills (447 total)
+### Atomic Skills (454 total)
 Each skill is **focused, self-contained, and composable**:
 - Average 320 lines - small enough to load quickly
 - Single responsibility - covers one clear topic
@@ -53,15 +53,15 @@ Each skill is **focused, self-contained, and composable**:
 
 ### Three-Tier Architecture
 
-**Tier 1: Gateway Skills (31 auto-discovered Agent Skills)**
+**Tier 1: Gateway Skills (32 auto-discovered Agent Skills)**
 Lightweight entry points that activate automatically based on keywords:
 - `discover-api` → triggers on "REST", "GraphQL", "authentication"
 - `discover-database` → triggers on "PostgreSQL", "MongoDB", "Redis"
 - `discover-zig` → triggers on "Zig", "comptime", "allocators"
 
 Each gateway is ~200 lines with quick reference and loading commands.
 
-**Tier 2: Category Indexes (30 detailed references)**
+**Tier 2: Category Indexes (31 detailed references)**
 Full skill listings with descriptions, use cases, and workflows:
 - `api/INDEX.md` → All 7 API skills with integration patterns
 - `database/INDEX.md` → All 11 database skills with decision trees
@@ -91,7 +91,7 @@ Complete implementation guides loaded only when needed:
 
 ## What's Covered
 
-### Core Development (125 skills)
+### Core Development (132 skills)
 
 **Languages & Frameworks**:
 - **Backend**: Python (uv), Zig, Rust, Go (31 skills)
@@ -110,6 +110,7 @@ Complete implementation guides loaded only when needed:
 - **Databases**: Postgres, MongoDB, Redis, Redpanda, Iceberg, DuckDB (11 skills)
 - **Caching**: Multi-layer (browser, HTTP, CDN, Redis), invalidation strategies (7 skills)
 - **API Design**: REST, GraphQL, auth, rate limiting, versioning (7 skills)
+- **Salesforce**: sf CLI, GUS/Agile Accelerator, SOQL, work items, Chatter, automation (7 skills)
 - **Data Engineering**: ETL, streaming, batch processing (5 skills)
 - **Testing**: Unit, integration, e2e, TDD, coverage (6 skills)
 
@@ -269,13 +270,14 @@ cat skills/database/redpanda-streaming.md
 │
 ├── README.md              # This file
 │
-└── skills/                # 283 atomic skills, 31 gateways, 30 categories
+└── skills/                # 290 atomic skills, 32 gateways, 31 categories
     │
     ├── README.md          # Skills catalog
     │
-    ├── Gateway Skills (31 auto-discovered Agent Skills)
+    ├── Gateway Skills (32 auto-discovered Agent Skills)
     │   ├── discover-api/           # REST, GraphQL, authentication
     │   ├── discover-database/      # PostgreSQL, MongoDB, Redis
+    │   ├── discover-salesforce/    # Salesforce CLI, GUS, SOQL
     │   ├── discover-frontend/      # React, Next.js, UI components
     │   ├── discover-ml/            # Machine learning, models
     │   ├── discover-math/          # Mathematics, algorithms
@@ -287,15 +289,17 @@ cat skills/database/redpanda-streaming.md
     │   ├── discover-workflow/      # Beads, context strategies
     │   └── ... 20 more gateways
     │
-    ├── Category Indexes (30 detailed references)
+    ├── Category Indexes (31 detailed references)
     │   ├── api/INDEX.md            # All API skills overview
     │   ├── database/INDEX.md       # All database skills overview
+    │   ├── salesforce/INDEX.md     # All Salesforce skills overview
     │   ├── ml/INDEX.md             # All ML skills overview
     │   └── ... 27 more indexes
     │
     └── Skills by Category
         ├── api/           # REST, GraphQL, auth (7)
         ├── database/      # Postgres, MongoDB, Redis, streaming (11)
+        ├── salesforce/    # sf CLI, GUS, SOQL, work items, Chatter (7)
         ├── frontend/      # React, Next.js, performance (8)
         ├── mobile/        # iOS/Swift, SwiftUI, SwiftData (10)
         ├── testing/       # Unit, integration, e2e (6)
@@ -349,6 +353,7 @@ cat skills/database/redpanda-streaming.md
 | **Debug** | GDB, LLDB, pdb, DevTools, Valgrind | 14 | discover-debugging |
 | **Cloud** | AWS, GCP, Modal, Vercel, Cloudflare | 27 | discover-cloud |
 | **Database** | Postgres, Mongo, Redis, Redpanda, Iceberg | 11 | discover-database |
+| **Salesforce** | sf CLI, GUS, SOQL, Chatter, Automation | 7 | discover-salesforce |
 | **Caching** | Redis, HTTP, CDN, Service Workers | 7 | discover-caching |
 | **ML/AI** | DSPy, HuggingFace, Arize, GraphRAG | 33 | discover-ml |
 | **Rust/PyO3** | DSPy integration, RAG, agents, async, production | 19 | N/A |
@@ -545,4 +550,4 @@ Feel free to fork and adapt for your own use. Pull requests welcome.
 
 ---
 
-**447 atomic skills** • **41 gateway Agent Skills** • **35+ categories** • **100% CI-validated**
+**454 atomic skills** • **32 gateway Agent Skills** • **31 categories** • **100% CI-validated**

skills/discover-salesforce/SKILL.md

@@ -0,0 +1,292 @@
+---
+name: discover-salesforce
+description: Automatically discover Salesforce CLI (sf) skills when working with Salesforce orgs, Agile Accelerator (GUS), SOQL queries, work items (WI, wis, wi, WIs), user stories, sprints, epics, or Chatter. Activates for Salesforce integration and automation tasks.
+---
+
+# Salesforce Skills Discovery
+
+Provides automatic access to comprehensive Salesforce CLI (sf) operations and Agile Accelerator (GUS) workflows.
+
+## When This Skill Activates
+
+This skill auto-activates when you're working with:
+- Salesforce CLI (sf) commands
+- Agile Accelerator (GUS) work items (WI), user stories, bugs
+- SOQL queries and data operations
+- Salesforce orgs and authentication
+- Creating or updating Salesforce records
+- Sprints, epics, and builds
+- Chatter posts and comments
+- Bulk data operations
+- Salesforce REST API integration
+- Any mention of WI (Work Items)
+
+## Available Skills
+
+### Quick Reference
+
+The Salesforce category contains **7 focused skills**:
+
+1. **sf-org-auth** - Authentication, org management, and user information
+2. **sf-soql-queries** - SOQL queries and data retrieval
+3. **sf-record-operations** - Creating and updating individual records
+4. **sf-work-items** - Managing work items, sprints, epics, and builds (GUS)
+5. **sf-chatter** - Chatter posts, comments, and feed interactions
+6. **sf-bulk-operations** - Bulk updates, exports, and large-scale operations
+7. **sf-automation** - Git integration, WI inference, and automated workflows
+
+**Note**: All examples dynamically detect your default org using `sf config get target-org`. You should set your default org with `sf config set target-org=<your-alias>`. Examples in the skills show how to fetch the default org dynamically to avoid hardcoding org aliases.
+
+### Load Full Category Details
+
+For complete descriptions and workflows:
+
+```bash
+cat ~/.claude/skills/salesforce/INDEX.md
+```
+
+This loads the full Salesforce category index with:
+- Detailed skill descriptions
+- Usage triggers for each skill
+- Common workflow combinations
+- Cross-references to related skills
+
+### Load Specific Skills
+
+Load individual skills as needed:
+
+```bash
+# Authentication and org management
+cat ~/.claude/skills/salesforce/sf-org-auth.md
+
+# SOQL queries and data retrieval
+cat ~/.claude/skills/salesforce/sf-soql-queries.md
+
+# Create/update individual records
+cat ~/.claude/skills/salesforce/sf-record-operations.md
+
+# Work items, sprints, and epics
+cat ~/.claude/skills/salesforce/sf-work-items.md
+
+# Chatter posts and comments
+cat ~/.claude/skills/salesforce/sf-chatter.md
+
+# Bulk operations and exports
+cat ~/.claude/skills/salesforce/sf-bulk-operations.md
+
+# Git integration and automation
+cat ~/.claude/skills/salesforce/sf-automation.md
+```
+
+## Common Workflows
+
+### Create User Story
+**Sequence**: Get user → Query IDs → Create work item → Add Chatter update
+
+```bash
+cat ~/.claude/skills/salesforce/sf-org-auth.md        # Get current user
+cat ~/.claude/skills/salesforce/sf-soql-queries.md    # Query for IDs
+cat ~/.claude/skills/salesforce/sf-work-items.md      # Create work item
+cat ~/.claude/skills/salesforce/sf-chatter.md          # Add Chatter post
+```
+
+### Sprint Planning
+**Sequence**: Create sprint → Query backlog → Bulk assign items
+
+```bash
+cat ~/.claude/skills/salesforce/sf-work-items.md        # Create sprint
+cat ~/.claude/skills/salesforce/sf-soql-queries.md      # Query backlog
+cat ~/.claude/skills/salesforce/sf-bulk-operations.md   # Bulk assign
+```
+
+### Bulk Status Update
+**Sequence**: Query work items → Export CSV → Bulk update → Verify
+
+```bash
+cat ~/.claude/skills/salesforce/sf-soql-queries.md       # Query items
+cat ~/.claude/skills/salesforce/sf-bulk-operations.md    # Bulk update
+```
+
+### Git Integration
+**Sequence**: Extract WI from branch → Query details → Update status → Post to Chatter
+
+```bash
+cat ~/.claude/skills/salesforce/sf-automation.md        # WI inference
+cat ~/.claude/skills/salesforce/sf-soql-queries.md      # Query WI
+cat ~/.claude/skills/salesforce/sf-work-items.md        # Update status
+cat ~/.claude/skills/salesforce/sf-chatter.md            # Post update
+```
+
+### Work Item Reporting
+**Sequence**: Query with related data → Export to CSV → Analyze
+
+```bash
+cat ~/.claude/skills/salesforce/sf-soql-queries.md       # Complex queries
+cat ~/.claude/skills/salesforce/sf-bulk-operations.md    # Export data
+```
+
+## Skill Selection Guide
+
+**Use sf-org-auth when:**
+- Logging into Salesforce orgs
+- Managing multiple org connections
+- Getting current user email/ID dynamically
+- Switching between environments
+
+**Use sf-soql-queries when:**
+- Querying Salesforce data
+- Finding record IDs (Users, Epics, Sprints, etc.)
+- Building reports or dashboards
+- Working with related objects
+
+**Use sf-record-operations when:**
+- Creating 1-5 records individually
+- Updating specific records by ID
+- Working with custom objects
+- Using REST API for advanced operations
+
+**Use sf-work-items when:**
+- Creating user stories, bugs, or tasks
+- Managing sprints and sprint planning
+- Working with epics and product tags
+- Sprint reporting
+
+**Use sf-chatter when:**
+- Posting updates to work items
+- Adding comments to records
+- Automating notifications from CI/CD
+
+**Use sf-bulk-operations when:**
+- Updating 10+ records at once
+- Exporting large datasets (>2000 records)
+- Bulk status changes
+- Avoiding API rate limits
+
+**Use sf-automation when:**
+- Extracting WI numbers from git branches
+- Automating Chatter posts from commits
+- Creating git hooks for Salesforce
+- CI/CD integration with GUS
+
+## Integration with Other Skills
+
+Salesforce skills commonly combine with:
+
+**API skills** (`discover-api`):
+- REST API integration with Salesforce
+- OAuth authentication for Salesforce
+- Custom API endpoints using Salesforce data
+- Webhook handling for Salesforce events
+
+**Workflow skills** (`discover-workflow`):
+- Automated work item creation from CI/CD
+- Status update automation based on deployments
+- Scheduled bulk operations
+- Integration with external systems
+
+**Data skills** (`discover-data`):
+- ETL operations with Salesforce data
+- Data transformation and analysis
+- Export/import workflows
+- Data quality and validation checks
+
+**Collaboration skills** (`discover-collaboration`):
+- Syncing GitHub issues with GUS work items
+- Automated Chatter updates from CI/CD
+- Cross-platform project management
+- Integration dashboards and reporting
+
+**Testing skills** (`discover-testing`):
+- Integration testing for Salesforce integrations
+- Automated testing of Salesforce workflows
+- Validation of Salesforce data operations
+- CI/CD integration with Salesforce deployments
+
+## Usage Instructions
+
+1. **Auto-activation**: This skill loads automatically when Claude Code detects Salesforce-related work
+2. **Browse skills**: Run `cat ~/.claude/skills/salesforce/INDEX.md` for full category overview
+3. **Load specific skills**: Use bash commands above to load individual skills
+4. **Follow patterns**: Each skill contains 5-10 patterns for common operations
+5. **Combine skills**: Load related skills for comprehensive Salesforce integration
+
+## Progressive Loading
+
+This gateway skill (~300 lines, ~3K tokens) enables progressive loading:
+- **Level 1**: Gateway loads automatically (you're here now)
+- **Level 2**: Load category INDEX.md (~350 lines, ~3.5K tokens) for full overview
+- **Level 3**: Load specific skill (~150-220 lines, ~1.5-2K tokens each) for detailed guidance
+
+Total context: 3K + 3.5K + (1.5-2K per skill) = efficient skill discovery and usage.
+
+## Quick Start Examples
+
+**"Authenticate to Salesforce"**:
+```bash
+cat ~/.claude/skills/salesforce/sf-org-auth.md
+```
+
+**"Query my work items"**:
+```bash
+cat ~/.claude/skills/salesforce/sf-soql-queries.md
+```
+
+**"Create a user story in GUS"**:
+```bash
+cat ~/.claude/skills/salesforce/sf-work-items.md
+```
+
+**"Update status for multiple work items"**:
+```bash
+cat ~/.claude/skills/salesforce/sf-bulk-operations.md
+```
+
+**"Post update to Chatter"**:
+```bash
+cat ~/.claude/skills/salesforce/sf-chatter.md
+```
+
+**"Extract WI from git branch"**:
+```bash
+cat ~/.claude/skills/salesforce/sf-automation.md
+```
+
+**"Export work items for reporting"**:
+```bash
+cat ~/.claude/skills/salesforce/sf-bulk-operations.md
+```
+
+## Best Practices
+
+**Always:**
+- **Use `sf` CLI tool directly** for all Salesforce operations
+- Infer WI number from git branch name when not explicitly provided
+- Dynamically fetch user email/ID and default org instead of hardcoding
+- Use `--target-org "$DEFAULT_ORG"` after fetching it dynamically to avoid ambiguity
+- Query for IDs before creating related records
+- Use bulk operations for 10+ record updates
+- Verify target org before destructive operations
+- Include all required fields when creating records
+- Validate query results before using extracted values
+
+**Never:**
+- Hardcode record IDs (they vary across orgs)
+- Hardcode user emails (fetch dynamically)
+- Update records without verifying they exist first
+- Use single updates in loops (use bulk operations)
+- Forget API name suffixes (`__c` for custom fields, `__r` for relationships)
+- Commit authentication tokens or credentials
+- Skip validation of jq output (check for null/empty)
+
+**Security:**
+- ⚠️ Always verify target org before updates
+- ⚠️ Query before update to verify record existence
+- ⚠️ Be cautious with bulk delete operations
+- ⚠️ Use `--target-org` flag for all operations
+- ⚠️ Never commit credentials to version control
+- ⚠️ Don't post sensitive data to Chatter
+- ⚠️ Test automation in sandbox before production
+
+---
+
+**Next Steps**: Run `cat ~/.claude/skills/salesforce/INDEX.md` to see full category details, or load specific skills using the commands above.