opencode-skills-antigravity 1.0.9 → 1.0.11

package/bundled-skills/docs/maintainers/security-findings-triage-2026-03-15.md

@@ -33,7 +33,7 @@
 | 8 | medium | Symlinked file copy in Microsoft skill sync can leak host data | `tools/scripts/sync_microsoft_skills.py` | duplicate of another finding | filesystem-trust-boundary | Same origin/main behavior as finding 7: the Microsoft sync path trusted resolved symlink targets and copied files from them. | Fix once in sync_microsoft_skills.py by constraining resolved paths to the clone root. | codex/security-filesystem-trust-boundary |
 | 9 | medium | Committed Python bytecode can hide malicious logic | `skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-314.pyc | skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-314.pyc` | still present but low practical risk | robustness | On origin/main, tracked __pycache__ artifacts were still present under skills/ui-ux-pro-max/scripts, which is review-hostile but not independently exploitable. | Remove tracked bytecode artifacts and rely on source-only review plus .gitignore. | codex/security-robustness |
 | 10 | medium | Symlinked SKILL.md can leak host files via index script | `tools/scripts/generate_index.py` | still present but low practical risk | filesystem-trust-boundary | On origin/main, generate_index.py opened every SKILL.md it found via os.walk and did not skip symlinked SKILL.md files, so a malicious local symlink could exfiltrate another file into index metadata generation. | Skip symlinked SKILL.md files during indexing. | codex/security-filesystem-trust-boundary |
-| 11 | low | Example loader trusts manifest paths, enabling file read | `docs/integrations/jetski-gemini-loader/loader.ts` | obsolete/not reproducible on current HEAD | n/a | On origin/main, the loader example resolves the requested file and rejects any path whose path.relative escapes the configured skills root, so the reported direct file read no longer reproduces. | n/a | n/a |
+| 11 | low | Example loader trusts manifest paths, enabling file read | `docs/integrations/jetski-gemini-loader/loader.mjs` | obsolete/not reproducible on current HEAD | n/a | On origin/main, the loader example resolves the requested file and rejects any path whose path.relative escapes the configured skills root, so the reported direct file read no longer reproduces. | n/a | n/a |
 | 12 | low | TLS certificate verification disabled in new scrapers | `skills/junta-leiloeiros/scripts/scraper/base_scraper.py | skills/junta-leiloeiros/scripts/web_scraper_fallback.py` | still present but low practical risk | auth-integrity | On origin/main, both the base scraper and the direct fallback client instantiated HTTP clients with verify=False / ignore_https_errors=True, which weakens transport integrity but is a local-run scraper risk rather than an application RCE. | Enable TLS verification by default and require an explicit environment opt-out for insecure targets. | codex/security-auth-integrity |
 | 13 | low | Complete bundle omits valid skill categories | `tools/lib/skill-filter.js | tools/scripts/build-catalog.js | data/bundles.json` | obsolete/not reproducible on current HEAD | n/a | On origin/main, shipped bundle data is generated by tools/scripts/build-catalog.js into data/bundles.json; the reported omission in tools/lib/skill-filter.js does not drive current shipped catalog data. | n/a | n/a |
 | 14 | low | Malformed frontmatter delimiter breaks YAML parsing for skills | `skills/alpha-vantage/SKILL.md | tools/lib/skill-utils.js` | still present but low practical risk | robustness | On origin/main, skills/alpha-vantage/SKILL.md still contained an extra delimiter token (--- Unknown), which caused parser warnings and broken metadata interpretation. | Repair the malformed frontmatter so the file is a valid YAML frontmatter document. | codex/security-robustness |

package/bundled-skills/docs/maintainers/security-findings-triage-2026-03-18-addendum.md

@@ -6,7 +6,7 @@ This addendum supersedes the previous Jetski loader assessment in
 ## Correction
 
 - Finding: `Example loader trusts manifest paths, enabling file read`
-- Path: `docs/integrations/jetski-gemini-loader/loader.ts`
+- Path: `docs/integrations/jetski-gemini-loader/loader.mjs`
 - Previous triage status on 2026-03-15: `obsolete/not reproducible on current HEAD`
 - Corrected assessment: the loader was still reproducible via a symlinked
   `SKILL.md` that resolved outside `skillsRoot`. A local proof read the linked

package/bundled-skills/docs/maintainers/skills-update-guide.md

@@ -69,7 +69,7 @@ For manual updates, you need:
 The update process refreshes:
 - Skills index (`skills_index.json`)
 - Web app skills data (`apps\web-app\public\skills.json`)
-- All 1,306+ skills from the skills directory
+- All 1,309+ skills from the skills directory
 
 ## When to Update
 

package/bundled-skills/docs/users/agent-overload-recovery.md

@@ -0,0 +1,54 @@
+# Antigravity Recovery for Context Overload and Truncation
+
+Use this guide when Antigravity loads too many skills for the current task and starts failing with truncation, context, or trajectory-conversion errors.
+
+Typical symptoms:
+
+- the agent crashes only when a large skills folder is present
+- the error mentions truncation, context conversion, or a trajectory/message that cannot be converted
+- the problem shows up more often on large repositories or long-running tasks
+
+## Linux and macOS fast path
+
+Use the activation scripts to keep the full library archived while exposing only the bundles or skills you need in the live Antigravity directory.
+
+1. Fully close Antigravity.
+2. Clone this repository somewhere local if you do not already have a clone.
+3. Run the activation script from the cloned repository.
+
+Examples:
+
+```bash
+./scripts/activate-skills.sh "Web Wizard" "Integration & APIs"
+./scripts/activate-skills.sh --clear
+./scripts/activate-skills.sh brainstorming systematic-debugging
+```
+
+What the script does:
+
+- syncs the repository `skills/` tree into `~/.gemini/antigravity/skills_library`
+- preserves your full library in the backing store
+- activates only the requested bundles or skill ids into `~/.gemini/antigravity/skills`
+- `--clear` archives the current live directory first, then restores the selected set
+
+Optional environment overrides:
+
+```bash
+AG_BASE_DIR=/custom/antigravity ./scripts/activate-skills.sh --clear Essentials
+AG_REPO_SKILLS_DIR=/path/to/repo/skills ./scripts/activate-skills.sh brainstorming
+```
+
+## Windows recovery
+
+If Antigravity is stuck in a restart loop on Windows, use the Windows-specific recovery guide instead:
+
+- [windows-truncation-recovery.md](windows-truncation-recovery.md)
+
+That guide covers the browser/app storage cleanup needed when the host keeps reopening the same broken session.
+
+## Prevention tips
+
+- start with 3-5 skills from a bundle instead of exposing the full library at once
+- use bundle activation before opening very large repositories
+- keep role-specific stacks active and archive the rest
+- if a host stores broken session state, clear that host state before restoring a smaller active set

package/bundled-skills/docs/users/bundles.md

@@ -579,4 +579,4 @@ Found a skill that should be in a bundle? Or want to create a new bundle? [Open
 
 ---
 
-_Last updated: March 2026 | Total Skills: 1,306+ | Total Bundles: 36_
+_Last updated: March 2026 | Total Skills: 1,309+ | Total Bundles: 36_

package/bundled-skills/docs/users/claude-code-skills.md

@@ -6,7 +6,7 @@ Antigravity Awesome Skills gives Claude Code users an installable library of `SK
 
 ## Why use this repo for Claude Code
 
-- It includes 1,306+ skills instead of a narrow single-domain starter pack.
+- It includes 1,309+ skills instead of a narrow single-domain starter pack.
 - It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
 - It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
 - It covers both everyday engineering tasks and specialized work like security reviews, infrastructure, product planning, and documentation.

package/bundled-skills/docs/users/faq.md

@@ -154,6 +154,14 @@ It includes:
 - the default Antigravity Windows paths to back up first
 - an optional batch script adapted from [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274)
 
+### I hit context overload on Linux or macOS. What should I do?
+
+If Antigravity becomes unstable only when the full skills library is active, switch to the activation flow instead of exposing every skill at once:
+
+- [agent-overload-recovery.md](agent-overload-recovery.md)
+
+That guide shows how to run `scripts/activate-skills.sh` from a cloned copy of this repository so only the bundles or skill ids you need stay active in `~/.gemini/antigravity/skills`.
+
 ### How do I update skills?
 
 Navigate to your skills directory and pull the latest changes:

package/bundled-skills/docs/users/gemini-cli-skills.md

@@ -8,7 +8,7 @@ Antigravity Awesome Skills supports Gemini CLI through the `.gemini/skills/` pat
 
 - It installs directly into the expected Gemini skills path.
 - It includes both core software engineering skills and deeper agent/LLM-oriented skills.
-- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,306+ files.
+- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,309+ files.
 - It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
 
 ## Install Gemini CLI Skills

package/bundled-skills/docs/users/getting-started.md

@@ -1,4 +1,4 @@
-# Getting Started with Antigravity Awesome Skills (V8.5.0)
+# Getting Started with Antigravity Awesome Skills (V8.7.1)
 
 **New here? This guide will help you supercharge your AI Agent in 5 minutes.**
 
@@ -142,6 +142,9 @@ A: Yes! Use the **@skill-creator** skill to build your own.
 **Q: What if Antigravity on Windows gets stuck in a truncation crash loop?**
 A: Follow the recovery steps in [windows-truncation-recovery.md](windows-truncation-recovery.md). It explains which Antigravity storage folders to back up and clear, and includes an optional batch helper adapted from [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274).
 
+**Q: What if Antigravity overloads on Linux or macOS when too many skills are active?**
+A: Use the activation flow in [agent-overload-recovery.md](agent-overload-recovery.md). It shows how to run `scripts/activate-skills.sh` from a cloned repo so you can keep the full library archived and activate only the bundles or skills you need in the live Antigravity directory.
+
 **Q: Is this free?**
 A: Yes. Original code and tooling are MIT-licensed, and original documentation/non-code written content is CC BY 4.0. See [../../LICENSE](../../LICENSE) and [../../LICENSE-CONTENT](../../LICENSE-CONTENT).
 

package/bundled-skills/docs/users/kiro-integration.md

@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
 
 Kiro's agentic capabilities are enhanced by skills that provide:
 
-- **Domain expertise** across 1,306+ specialized areas
+- **Domain expertise** across 1,309+ specialized areas
 - **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
 - **Workflow automation** for common development tasks
 - **AWS-specific patterns** for serverless, infrastructure, and cloud architecture

package/bundled-skills/docs/users/usage.md

@@ -12,7 +12,7 @@ Great question! Here's what just happened and what to do next:
 
 When you ran `npx antigravity-awesome-skills` or cloned the repository, you:
 
-✅ **Downloaded 1,306+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)  
+✅ **Downloaded 1,309+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)  
 ✅ **Made them available** to your AI assistant  
 ❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
 
@@ -32,7 +32,7 @@ Bundles are **recommended lists** of skills grouped by role. They help you decid
 
 **Analogy:**
 
-- You installed a toolbox with 1,306+ tools (✅ done)
+- You installed a toolbox with 1,309+ tools (✅ done)
 - Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools"
 - You don't install bundles—you **pick skills from them**
 
@@ -40,7 +40,7 @@ Bundles are **recommended lists** of skills grouped by role. They help you decid
 
 ❌ Separate installations  
 ❌ Different download commands  
-❌ Something you need to "activate"
+❌ Something most users need to activate during normal install
 
 ### Example: The "Web Wizard" Bundle
 
@@ -192,7 +192,7 @@ Let's actually use a skill right now. Follow these steps:
 
 ## Step 5: Picking Your First Skills (Practical Advice)
 
-Don't try to use all 1,306+ skills at once. Here's a sensible approach:
+Don't try to use all 1,309+ skills at once. Here's a sensible approach:
 
 If you want a tool-specific starting point before choosing skills, use:
 
@@ -323,7 +323,7 @@ Usually no, but if your AI doesn't recognize a skill:
 
 ### "Can I load all skills into the model at once?"
 
-No. Even though you have 1,306+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
+No. Even though you have 1,309+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
 
 The intended pattern is:
 

package/bundled-skills/docs/users/visual-guide.md

@@ -34,7 +34,7 @@ antigravity-awesome-skills/
 ├── 📄 CONTRIBUTING.md                  ← Contributor workflow
 ├── 📄 CATALOG.md                       ← Full generated catalog
 │
-├── 📁 skills/                          ← 1,306+ skills live here
+├── 📁 skills/                          ← 1,309+ skills live here
 │   │
 │   ├── 📁 brainstorming/
 │   │   └── 📄 SKILL.md                 ← Skill definition
@@ -47,7 +47,7 @@ antigravity-awesome-skills/
 │   │   └── 📁 2d-games/
 │   │       └── 📄 SKILL.md             ← Nested skills also supported
 │   │
-│   └── ... (1,306+ total)
+│   └── ... (1,309+ total)
 │
 ├── 📁 apps/
 │   └── 📁 web-app/                     ← Interactive browser
@@ -100,7 +100,7 @@ antigravity-awesome-skills/
 
 ```
                     ┌─────────────────────────┐
-                    │  1,306+ SKILLS          │
+                    │  1,309+ SKILLS          │
                     └────────────┬────────────┘
                                  │
         ┌────────────────────────┼────────────────────────┐
@@ -201,7 +201,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
 │   ├── 📁 brainstorming/                 │
 │   ├── 📁 stripe-integration/            │
 │   ├── 📁 react-best-practices/          │
-│   └── ... (1,306+ total)                │
+│   └── ... (1,309+ total)                │
 └─────────────────────────────────────────┘
 ```
 

package/bundled-skills/gdb-cli/SKILL.md

@@ -0,0 +1,239 @@
+---
+name: gdb-cli
+description: "GDB debugging assistant for AI agents - analyze core dumps, debug live processes, investigate crashes and deadlocks with source code correlation"
+category: development
+risk: critical
+source: community
+date_added: "2026-03-22"
+author: Cerdore
+tags:
+- debugging
+- gdb
+- core-dump
+- crash-analysis
+- c++
+- c
+tools:
+- claude-code
+- cursor
+- gemini-cli
+- codex-cli
+- antigravity
+---
+
+# GDB Debugging Assistant
+
+## Overview
+
+A GDB debugging skill designed for AI agents. Combines **source code analysis** with **runtime state inspection** using gdb-cli to provide intelligent debugging assistance for C/C++ programs.
+
+## When to Use This Skill
+
+- Analyze core dumps or crash dumps
+- Debug running processes with GDB attach
+- Investigate crashes, deadlocks, or memory issues
+- Get intelligent debugging assistance with source code context
+- Debug multi-threaded applications
+
+## Do Not Use This Skill When
+
+- The task is unrelated to C/C++ debugging
+- The user needs general-purpose assistance without debugging
+- No GDB is available (GDB 9.0+ with Python support required)
+
+## Prerequisites
+
+```bash
+# Install gdb-cli
+pip install gdb-cli
+
+# Or from GitHub
+pip install git+https://github.com/Cerdore/gdb-cli.git
+
+# Verify GDB has Python support
+gdb -nx -q -batch -ex "python print('OK')"
+```
+
+**Requirements:**
+- Python 3.6.8+
+- GDB 9.0+ with Python support enabled
+- Linux OS
+
+## How It Works
+
+### Step 1: Initialize Debug Session
+
+**For core dump analysis:**
+```bash
+gdb-cli load --binary <binary_path> --core <core_path> [--gdb-path <gdb_path>]
+```
+
+**For live process debugging:**
+```bash
+gdb-cli attach --pid <pid> [--binary <binary_path>]
+```
+
+**Output:** A session_id like `"session_id": "a1b2c3"`. Store this for subsequent commands.
+
+### Step 2: Gather Initial Information
+
+```bash
+SESSION="<session_id>"
+
+# List all threads
+gdb-cli threads -s $SESSION
+
+# Get backtrace (with local variables)
+gdb-cli bt -s $SESSION --full
+
+# Get registers
+gdb-cli registers -s $SESSION
+```
+
+### Step 3: Correlate Source Code (CRITICAL)
+
+For each frame in the backtrace:
+1. **Extract frame info**: `{file}:{line} in {function}`
+2. **Read source context**: Get ±20 lines around the crash point
+3. **Get local variables**: `gdb-cli locals-cmd -s $SESSION --frame <N>`
+4. **Analyze**: Correlate code logic with variable values
+
+**Example correlation:**
+```
+Frame #0: process_data() at src/worker.c:87
+Source code shows:
+  85: Node* node = get_node(id);
+  86: if (node == NULL) return;
+  87: node->data = value;  <- Crash here
+
+Variables show:
+  node = 0x0 (NULL)
+
+Analysis: The NULL check on line 86 didn't catch the issue.
+```
+
+### Step 4: Deep Investigation
+
+```bash
+# Examine variables
+gdb-cli eval-cmd -s $SESSION "variable_name"
+gdb-cli eval-cmd -s $SESSION "ptr->field"
+gdb-cli ptype -s $SESSION "struct_name"
+
+# Memory inspection
+gdb-cli memory -s $SESSION "0x7fffffffe000" --size 64
+
+# Disassembly
+gdb-cli disasm -s $SESSION --count 20
+
+# Check all threads (for deadlock analysis)
+gdb-cli thread-apply -s $SESSION bt --all
+
+# View shared libraries
+gdb-cli sharedlibs -s $SESSION
+```
+
+### Step 5: Session Management
+
+```bash
+# List active sessions
+gdb-cli sessions
+
+# Check session status
+gdb-cli status -s $SESSION
+
+# Stop session (cleanup)
+gdb-cli stop -s $SESSION
+```
+
+## Common Debugging Patterns
+
+### Pattern: Null Pointer Dereference
+
+**Indicators:**
+- Crash on memory access instruction
+- Pointer variable is 0x0
+
+**Investigation:**
+```bash
+gdb-cli registers -s $SESSION  # Check RIP
+gdb-cli eval-cmd -s $SESSION "ptr"  # Check pointer value
+```
+
+### Pattern: Deadlock
+
+**Indicators:**
+- Multiple threads stuck in lock functions
+- `pthread_mutex_lock` in backtrace
+
+**Investigation:**
+```bash
+gdb-cli thread-apply -s $SESSION bt --all
+# Look for circular wait patterns
+```
+
+### Pattern: Memory Corruption
+
+**Indicators:**
+- Crash in malloc/free
+- Garbage values in variables
+
+**Investigation:**
+```bash
+gdb-cli memory -s $SESSION "&variable" --size 128
+gdb-cli registers -s $SESSION
+```
+
+## Examples
+
+### Example 1: Core Dump Analysis
+
+```bash
+# Load core dump
+gdb-cli load --binary ./myapp --core /tmp/core.1234
+
+# Get crash location
+gdb-cli bt -s a1b2c3 --full
+
+# Examine crash frame
+gdb-cli locals-cmd -s a1b2c3 --frame 0
+```
+
+### Example 2: Live Process Debugging
+
+```bash
+# Attach to stuck server
+gdb-cli attach --pid 12345
+
+# Check all threads
+gdb-cli threads -s b2c3d4
+
+# Get all backtraces
+gdb-cli thread-apply -s b2c3d4 bt --all
+```
+
+## Best Practices
+
+- Always read source code before drawing conclusions from variable values
+- Use `--range` for pagination on large thread counts or deep backtraces
+- Use `ptype` to understand complex data structures before examining values
+- Check all threads for multi-threaded issues
+- Cross-reference types with source code definitions
+
+## Security & Safety Notes
+
+- This skill requires GDB access to processes and core dumps
+- Attaching to processes may require appropriate permissions (sudo, ptrace_scope)
+- Core dumps may contain sensitive data - handle with care
+- Only debug processes you have authorization to analyze
+
+## Related Skills
+
+- `@systematic-debugging` - General debugging methodology
+- `@test-driven-development` - Write tests before implementation
+
+## Links
+
+- **Repository**: https://github.com/Cerdore/gdb-cli
+- **PyPI**: https://pypi.org/project/gdb-cli/
+- **Documentation**: https://github.com/Cerdore/gdb-cli#readme

package/bundled-skills/jobgpt/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: jobgpt
+description: "Job search automation, auto apply, resume generation, application tracking, salary intelligence, and recruiter outreach using the JobGPT MCP server."
+risk: safe
+source: community
+date_added: "2026-03-23"
+---
+
+# JobGPT - Job Search Automation
+
+## Overview
+
+JobGPT connects your AI assistant to a complete job search automation platform via the JobGPT MCP server. It provides 34 tools covering job search, auto-apply, resume generation, application tracking, salary intelligence, and recruiter outreach so you can manage your entire job hunt from your AI coding assistant.
+
+Built by [6figr.com](https://6figr.com/jobgpt-ai), the platform supports 150+ countries with salary data, job matching, and automated applications.
+
+## When to Use This Skill
+
+- You want to **search for jobs** with filters like titles, locations, salary, remote, and H1B sponsorship
+- You want to **auto-apply** to jobs automatically
+- You want to **generate a tailored resume** for a specific job application
+- You want to **track your job applications** across multiple job hunts
+- You want to **find recruiters or referrers** at target companies and send outreach emails
+- You want to **import a job** from LinkedIn, Greenhouse, Lever, Workday, or any job board URL
+- You want to **check your salary** and compare compensation across roles
+
+## Setup
+
+This skill requires the JobGPT MCP server:
+
+1. **Create an account** - Sign up at [6figr.com/jobgpt-ai](https://6figr.com/jobgpt-ai)
+2. **Get an API key** - Go to [6figr.com/account](https://6figr.com/account), scroll to MCP Integrations, and click Generate API Key. The key starts with `mcp_`.
+3. **Add the MCP server:**
+   - Claude Code: `claude mcp add jobgpt -t http -u https://mcp.6figr.com/mcp --header "Authorization: <api-key>"`
+   - Other tools: Add `jobgpt-mcp-server` as an MCP server with env var `JOBGPT_API_KEY` set. Install via `npx jobgpt-mcp-server`.
+
+Set the `JOBGPT_API_KEY` environment variable when you are running the local `npx jobgpt-mcp-server` path.
+
+## Examples
+
+### Find Remote Jobs
+
+> "Find remote senior React jobs paying over $150k"
+
+The skill uses `search_jobs` with title, remote, and salary filters to find matching positions, then presents results with company, title, location, salary range, and key skills.
+
+### Auto-Apply to Jobs
+
+> "Auto-apply to the top 5 matches from my job hunt"
+
+The skill checks that your resume is uploaded, uses `match_jobs` to find new matches, saves the selected matches with `add_job_to_applications`, then triggers `apply_to_job` for each resulting application. It monitors progress with `get_application_stats`.
+
+### Generate a Tailored Resume
+
+> "Generate a tailored resume for this Google application"
+
+The skill calls `generate_resume_for_job` to create an AI-optimized resume targeting the specific job's requirements, then provides the download link via `get_generated_resume`.
+
+### Import and Apply from a URL
+
+> "Apply to this job for me - https://boards.greenhouse.io/company/jobs/12345"
+
+The skill uses `import_job_by_url` to import the job from any supported platform (LinkedIn, Greenhouse, Lever, Workday), adds it to applications, and optionally triggers auto-apply.
+
+### Recruiter Outreach
+
+> "Find recruiters for this job and draft an outreach email"
+
+The skill finds recruiters with `get_job_recruiters` and helps craft a personalized message. The draft is presented to the user for review; `send_outreach` is only called after explicit user confirmation.
+
+### Check Application Stats
+
+> "Show my application stats for the last 7 days"
+
+The skill uses `get_application_stats` for an aggregated overview - total counts by status, auto-apply metrics, and pipeline progress.
+
+## Best Practices
+
+- **Check credits first** - Auto-apply and resume generation consume credits. Use `get_credits` before batch operations.
+- **Complete your profile** - Run `get_profile` first and fill in missing fields with `update_profile` for better job matches.
+- **Upload a resume before applying** - Use `list_resumes` to check, and `upload_resume` if needed.
+- **Use job hunts for ongoing searches** - Create a job hunt with `create_job_hunt` to save filters and get continuous matches.
+- **Use `get_application` for saved jobs** - If a user asks about a job they've already saved, use `get_application` instead of `get_job`.
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| "Missing Authorization header" | For Claude Code and other remote HTTP MCP setups, confirm the `Authorization` header is configured on the MCP server entry |
+| "Missing API key" | For the local `npx jobgpt-mcp-server` setup, ensure `JOBGPT_API_KEY` is set to your API key |
+| "Insufficient credits" | Check balance with `get_credits`. Purchase more at 6figr.com/account |
+| Auto-apply not working | Ensure a resume is uploaded and the job hunt has auto-apply enabled |
+| No job matches found | Broaden your search filters (fewer titles, more locations, wider salary range) |
+
+## Additional Resources
+
+- [JobGPT Platform](https://6figr.com/jobgpt-ai) - Sign up and manage your account
+- [MCP Server Repo](https://github.com/6figr-com/jobgpt-mcp-server) - Source code and setup guides
+- [Skills Repo](https://github.com/6figr-com/skills) - This skill's source
+- [npm Package](https://www.npmjs.com/package/jobgpt-mcp-server) - Install via npm