Semantic Analyst
sidequery/sidemantic
Answer analytical, KPI, metric, trend, cohort, and business-performance questions through a Sidemantic semantic layer.
Diagnoses and resolves MCP server registration failures, GPU detection, BigQuery authentication, index build failures, import errors, search quality issues, and performance problems.
Install Troubleshooting Assistant
$ npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install RobThePCGuy/Claude-Patent-Creator troubleshooting-assistant --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/RobThePCGuy/Claude-Patent-Creator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/troubleshooting-assistant .claude/skills/troubleshooting-assistant && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "troubleshooting-assistant" agent skill from https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistant into .claude/skills/troubleshooting-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting-assistant", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistantType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install RobThePCGuy/Claude-Patent-Creator troubleshooting-assistant --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RobThePCGuy/Claude-Patent-Creator.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/troubleshooting-assistant .agents/skills/troubleshooting-assistant && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "troubleshooting-assistant" agent skill from https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistant into .agents/skills/troubleshooting-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting-assistant", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install RobThePCGuy/Claude-Patent-Creator troubleshooting-assistant --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RobThePCGuy/Claude-Patent-Creator.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/troubleshooting-assistant .cursor/skills/troubleshooting-assistant && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "troubleshooting-assistant" agent skill from https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistant into .cursor/skills/troubleshooting-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting-assistant", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/RobThePCGuy/Claude-Patent-Creator.git --path skills/troubleshooting-assistant--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install RobThePCGuy/Claude-Patent-Creator troubleshooting-assistant --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RobThePCGuy/Claude-Patent-Creator.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/troubleshooting-assistant .gemini/skills/troubleshooting-assistant && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "troubleshooting-assistant" agent skill from https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistant into .gemini/skills/troubleshooting-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting-assistant", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install RobThePCGuy/Claude-Patent-Creator troubleshooting-assistantInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/RobThePCGuy/Claude-Patent-Creator.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/troubleshooting-assistant .github/skills/troubleshooting-assistant && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "troubleshooting-assistant" agent skill from https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistant into .github/skills/troubleshooting-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting-assistant", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install RobThePCGuy/Claude-Patent-Creator troubleshooting-assistant --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/RobThePCGuy/Claude-Patent-Creator.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/troubleshooting-assistant .opencode/skills/troubleshooting-assistant && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "troubleshooting-assistant" agent skill from https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistant into .opencode/skills/troubleshooting-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting-assistant", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
troubleshooting-assistant- GitHub stars
- 196
- Token cost
- ~1.2k tokens
- SKILL.md length
- 328 words
- Files
- 1
- Skills in repo
- 17
- Repo updated
- First seen
- Licence
- MIT
At a glance
Diagnoses and resolves MCP server registration failures, GPU detection, BigQuery authentication, index build failures, import errors, search quality issues, and performance problems.
- Works in 8 steps: Regular health checks (weekly… → Monitor logs for warnings/errors → Keep dependencies updated (test before… → …
- Tasks that involve Data warehousing
- SKILL.md covers When to Use, Troubleshooting Methodology, Common Issues & Quick Fixes and Detailed Issue Guides, plus 3 more sections
- Calls python, claude and gcloud
What it does
Troubleshooting Assistant is an agent skill from RobThePCGuy/Claude-Patent-Creator. Diagnoses and resolves MCP server registration failures, GPU detection, BigQuery authentication, index build failures, import errors, search quality issues, and performance problems.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Databases, covering Data warehousing, Intellectual property and MCP servers. It works with Model Context Protocol, Google BigQuery and CUDA. The repository describes itself as: USPTO patent creation system with MCP server + Claude Code plugin. Hybrid RAG search over MPEP/USC/CFR, BigQuery access to 76M+ patents, automated 35 USC 112 compliance checks… The licence is MIT.
When your agent uses it
- Tasks that involve Data warehousing
- Tasks that involve Intellectual property
- Tasks that involve MCP servers
Example prompts
- “Use the troubleshooting-assistant skill to diagnose and resolves MCP server registration failures, GPU detection, BigQuery authentication, index…”
- “/troubleshooting-assistant”
Requirements
- Python 3
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- Regular health checks (weekly patent-creator health)
- Monitor logs for warnings/errors
- Keep dependencies updated (test before deploying)
- Backup before changes (especially index rebuilds)
- Document modifications
- Test after changes (run test suite)
- Version control (use git)
- Environment consistency (same Python/CUDA versions)
What it can do on your machine
Read from SKILL.md and the folder at commit a089731. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
pythonclaudegcloud
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gcloud, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Troubleshooting Assistant loads about 1.2k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 328 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from RobThePCGuy/Claude-Patent-Creator at commit a089731, republished under its MIT licence (© RobThePCGuy). 328 words, ~1,174 tokens.
Download SKILL.mdSave it as
.claude/skills/troubleshooting-assistant/SKILL.md (or your agent's skills folder).- name
- troubleshooting-assistant
- description
- Diagnoses and resolves MCP server registration failures, GPU detection, BigQuery authentication, index build failures, import errors, search quality issues, and performance problems.
Troubleshooting Assistant Skill
Expert diagnostic system for identifying and resolving Claude Patent Creator issues.
When to Use
System not working, error messages, slow performance, MCP server not loading, search returns no results/errors, GPU not detected, BigQuery auth fails, index build fails, tests failing, unexpected behavior.
Troubleshooting Methodology
Problem Reported
|
[1] Gather Information (errors, recent changes, system state)
|
[2] Reproduce Issue (minimal test case, consistent?)
|
[3] Isolate Component (which part failing? dependencies?)
|
[4] Diagnose Root Cause (check logs, test components, verify config)
|
[5] Apply Fix (targeted solution, verify works)
|
[6] Prevent Recurrence (document, add monitoring, update checks)Common Issues & Quick Fixes
| Issue | Quick Fix |
|---|---|
| MCP server not loading | claude mcp list -> Re-register if missing |
| GPU not detected | Reinstall PyTorch with CUDA |
| BigQuery auth fails | gcloud auth application-default login |
| Index not found | patent-creator rebuild-index |
| Import errors | Activate venv: venv\Scripts\activate |
| Slow searches | Check GPU usage, reduce top_k, disable HyDE |
| Irrelevant results | Rephrase query with MPEP terminology |
Detailed Issue Guides
MCP Server Issues
Problems: Server not loading, tools don't work/return errors
- 5-step diagnostic workflow
- Path verification and correction
- Dependency troubleshooting
- Server restart procedures
GPU & BigQuery Issues
Problems: GPU not detected, slow performance, BigQuery auth fails, query timeouts
- CUDA detection and PyTorch reinstallation
- Performance diagnostics and optimization
- BigQuery authentication and permissions
- Timeout configuration
Index, Dependencies & Configuration
Problems: Index not found, build fails, ModuleNotFoundError, import errors, env vars not loading, irrelevant search results
- Index rebuild procedures
- OOM (Out of Memory) solutions
- Virtual environment activation
- Pydantic validation errors
- Configuration troubleshooting
- Search quality tuning
Diagnostic Tools
Health Check Suite
# Full system health
patent-creator health
# Individual components
python scripts/test_gpu.py
python scripts/test_bigquery.py
python scripts/test_analyzers.py
python scripts/test_install.pyComponent Isolation
# Test MPEP search
python -c "from mcp_server.mpep_search import MPEPIndex; \
index = MPEPIndex(); index.build_index(); \
print('OK' if index.search('test', top_k=1) else 'FAILED')"
# Test BigQuery
python -c "from mcp_server.bigquery_search import BigQueryPatentSearch; \
search = BigQueryPatentSearch(); \
print('OK' if search.search_by_keywords('neural network', limit=1) else 'FAILED')"
# Test analyzers
python -c "from mcp_server.claims_analyzer import ClaimsAnalyzer; \
analyzer = ClaimsAnalyzer(); \
print('OK' if analyzer.analyze('1. A test claim.') else 'FAILED')"- Log analysis (debug mode)
- MCP communication debugging
- Performance profiling
- Memory profiling
- Issue escalation procedures
Best Practices for Prevention
- Regular health checks (weekly
patent-creator health) - Monitor logs for warnings/errors
- Keep dependencies updated (test before deploying)
- Backup before changes (especially index rebuilds)
- Document modifications
- Test after changes (run test suite)
- Version control (use git)
- Environment consistency (same Python/CUDA versions)
Quick Reference
Most Common Errors
| Error | Category | Solution |
|---|---|---|
| "Tool not found" | MCP | claude mcp list |
| "ModuleNotFoundError" | Dependencies | Activate venv, reinstall |
| "CUDA not available" | GPU | Reinstall PyTorch with CUDA |
| "Permission denied" (BigQuery) | Auth | gcloud auth application-default login |
| "Index not found" | Index | patent-creator rebuild-index |
| "Out of memory" | Index Build | Reduce batch size |
| "Validation error" | Input | Check Pydantic model parameters |
Diagnostic Commands
# System health
patent-creator health
# Test components
python scripts/test_gpu.py
python scripts/test_bigquery.py
python scripts/test_install.py
# Check registration
claude mcp list
# Check paths
patent-creator verify-config
# Enable debug logging
export PATENT_LOG_LEVEL=DEBUG© RobThePCGuy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/troubleshooting-assistant of RobThePCGuy/Claude-Patent-Creator.
Open the folder on GitHubat commit a089731
Compare with similar skills
Troubleshooting Assistant next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Troubleshooting Assistant this skillRobThePCGuy/Claude-Patent-Creator | 196 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Semantic Analystsidequery/sidemantic | 129 | — | ~982 | Automated safety check: Pass | AGPL-3.0 | |
| Google Cloud Storage Basicsgoogle/skills | 21k | — | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| Pytorch Clickhousepytorch/test-infra | 113 | — | ~2.8k | Automated safety check: Pass | Custom licence | |
| Imaging Data CommonsK-Dense-AI/scientific-agent-skills | 48k | 1 repos | ~7.8k | Automated safety check: Pass | MIT | |
| Moraine Sandbox QAeric-tramel/moraine | 117 | — | ~668 | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Google Cloud Storage Basics
google/skills
Stores, retrieves, and manages data as objects in Cloud Storage on Google Cloud (also known colloquially as GCS) buckets.
Pytorch Clickhouse
pytorch/test-infra
Load this FIRST whenever working with PyTorch CI data (any pytorch/ org repo), the torchci/HUD codebase, or the PyTorch HUD ClickHouse database.
Imaging Data Commons
K-Dense-AI/scientific-agent-skills
Queries and downloads public cancer imaging data from NCI Imaging Data Commons.
Moraine Sandbox QA
eric-tramel/moraine
Run isolated Moraine dev sandbox validation. An agent skill from eric-tramel/moraine.
Bigquery Basics
davila7/claude-code-templates
Manages datasets, tables, and jobs in BigQuery, and integrates with BigQuery ML and Gemini for advanced data analytics and AI-driven insights.
More from RobThePCGuy/Claude-Patent-Creator
All 17 skills in this repoPatent Claims Analyzer
RobThePCGuy/Claude-Patent-Creator
Automated analysis of patent claims for USPTO compliance with 35 USC 112(b) requirements - antecedent basis, definiteness, claim structure
Patent Reviewer
RobThePCGuy/Claude-Patent-Creator
Expert system for reviewing utility patent applications against USPTO MPEP guidelines.
Bigquery Patent Search
RobThePCGuy/Claude-Patent-Creator
Fast, cloud-based patent searching across 100 million+ worldwide patents using Google BigQuery - keyword search, CPC classification, patent details retrieval
Development Assistant
RobThePCGuy/Claude-Patent-Creator
Guides through adding new features, MCP tools, analyzers, and extending the patent creator system.
Epc Search
RobThePCGuy/Claude-Patent-Creator
RAG search across EPC provisions, EPO Guidelines for Examination, and PCT rules for European and international patent law research
Epo Patent Analyzer
RobThePCGuy/Claude-Patent-Creator
Automated analysis of patent applications for EPO compliance with Art.
Related
Categories
Questions about Troubleshooting Assistant
What does Troubleshooting Assistant do?
Diagnoses and resolves MCP server registration failures, GPU detection, BigQuery authentication, index build failures, import errors, search quality issues, and performance problems. Troubleshooting Assistant is an agent skill from RobThePCGuy/Claude-Patent-Creator. Diagnoses and resolves MCP server registration failures, GPU detection, BigQuery authentication, index build failures, import errors, search quality issues, and performance problems.
When should I use Troubleshooting Assistant?
Troubleshooting Assistant fits situations like: tasks that involve Data warehousing; tasks that involve Intellectual property; tasks that involve MCP servers.
How do I install Troubleshooting Assistant in Claude Code?
Run `npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a claude-code`. Or copy the skill folder (skills/troubleshooting-assistant in RobThePCGuy/Claude-Patent-Creator) into .claude/skills/troubleshooting-assistant in your project. Claude Code loads it when a task matches its description.
How do I install Troubleshooting Assistant in Codex?
Run `npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a codex`. Or copy the skill folder (skills/troubleshooting-assistant in RobThePCGuy/Claude-Patent-Creator) into .agents/skills/troubleshooting-assistant in your project. Codex loads it when a task matches its description.
Can I use Troubleshooting Assistant in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/troubleshooting-assistant, .gemini/skills/troubleshooting-assistant, .github/skills/troubleshooting-assistant and .opencode/skills/troubleshooting-assistant in your project.
What does Troubleshooting Assistant need to run?
Going by SKILL.md and its folder, Troubleshooting Assistant needs the command-line tools its instructions call (python, claude and gcloud). Our summary lists: Python 3.
Does Troubleshooting Assistant access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Troubleshooting Assistant safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Troubleshooting Assistant use?
Troubleshooting Assistant is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Troubleshooting Assistant use?
About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Troubleshooting Assistant?
Skills that share tags, products or a category with Troubleshooting Assistant: Semantic Analyst (sidequery/sidemantic, 129 stars), Google Cloud Storage Basics (google/skills, 21k stars), Pytorch Clickhouse (pytorch/test-infra, 113 stars) and Imaging Data Commons (K-Dense-AI/scientific-agent-skills, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Troubleshooting Assistant?
RobThePCGuy (a GitHub user) maintains it in RobThePCGuy/Claude-Patent-Creator, which has 196 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.
Source: RobThePCGuy/Claude-Patent-Creator on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.