Commit 8c181cc45589

@@ -59,6 +59,22 @@ All reviewer agents share the rubric defined in `rubric.md`. It covers:
 - Comment guidelines
 - Output format
 
+## Examples
+
+**Example 1: Security-focused review**
+```
+User: "Review this PR for security issues"
+→ Invokes FocusedReview workflow with security focus
+→ Checks for injection, auth, secrets exposure
+```
+
+**Example 2: Full review**
+```
+User: "Review PR #123"
+→ Invokes FullReview workflow
+→ Covers architecture, correctness, security, performance
+```
+
 ## Repository-Specific Guidelines
 
 Place repo-specific review rules in `repositories/<org>-<repo>.md` (e.g., `repositories/tektoncd-pipeline.md`). These are automatically loaded by the `/review` extension.

@@ -58,3 +58,13 @@ gh run view <run_id> --log
 
 - **GitHub**: PR management, check status reporting, CI restarts
 - **CodeReview**: Code review with `architecture` focus via oracle subagent
+
+## Examples
+
+**Example 1: Fix failing CI**
+```
+User: "CI is failing on my PR"
+→ Inspects PR checks via GitHub API
+→ Identifies failing jobs, downloads logs
+→ Diagnoses root cause and applies fix
+```

@@ -65,3 +65,13 @@ gh api graphql -f query='mutation { resolveReviewThread(input: {threadId: "<thre
 
 - **GitHub**: PR management, ResolvePRComments workflow (for human review comments)
 - **GHFixCI**: For CI check failures (different from review comments)
+
+## Examples
+
+**Example 1: Triage bot feedback**
+```
+User: "Handle the bot comments on my PR"
+→ Fetches unresolved bot review comments
+→ Classifies each as valid/invalid/unclear
+→ Implements fixes for valid ones, replies to dismiss invalid ones
+```

@@ -62,3 +62,12 @@ The script auto-detects the repository name from git remote and creates the dire
 
 - **CORE**: Session saves via `save_session_to_history` (documenting past work)
 - **WritingPlans**: For creating implementation plans (forward-looking)
+
+## Examples
+
+**Example 1: Write a handoff**
+```
+User: "Write a handoff for this work"
+→ Captures current state, decisions made, open items
+→ Writes structured handoff doc for next session/engineer
+```

@@ -180,6 +180,15 @@ org-manager export-json ~/desktop/org/todos.org /tmp/todos.json
 - Emacs with org-mode
 - `org-batch-functions.el` in `~/.config/emacs/site-lisp/`
 
+## Examples
+
+**Example 1: Manage org headings**
+```
+User: "Add a new section to my notes"
+→ Uses org-manager to manipulate org file structure
+→ Adds heading with proper level and content
+```
+
 ## Related Skills
 
 - **TODOs** - Uses org-manager for TODO operations

@@ -1,6 +1,6 @@
 ---
 name: pi-share
-description: "Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com (pi-share) URLs. Fetches gists, decodes embedded session data, and extracts conversation history."
+description: Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com (pi-share) URLs. USE WHEN user shares a pi-share URL, buildwithpi URL, or gist ID and wants to load, analyze, or summarize a coding agent session.
 ---
 
 # pi-share / buildwithpi Session Loader

@@ -60,6 +60,15 @@ This skill produces a single self-contained HTML file with:
 | Team | R&D Secure Flow |
 | Manager | Eyal Edri, Director Engineering |
 
+## Examples
+
+**Example 1: Generate Q1 report**
+```
+User: "Generate my Q1 2025 report"
+→ Gathers data from git, Jira, GitHub, emails
+→ Renders polished HTML achievement report
+```
+
 ## Output
 
 The report is written to `~/desktop/downloads/q<N>-<YEAR>-achievements-vincent-demeester.html`.

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# SlackRead.sh: Read-only Slack CLI
+# shellcheck disable=SC2046,SC2064,SC2086,SC2015
+# slack-read.sh: Read-only Slack CLI
 # Supports two backends:
 #   - curl: for Enterprise Grid workspaces (Red Hat) using passage-stored tokens
 #   - slackdump: for regular workspaces (Tekton) using slackdump's auth