Back to list
geggo98

research

by geggo98

Dotfiles for Codespaces

1🍴 0📅 Jan 23, 2026

SKILL.md


name: research description: Researches how to use an API, library, or reference architecture. Fallback when the WebSearch tool fails.

Research Skill

1. Purpose

Use this skill to research APIs, libraries, or design patterns before implementation. It produces concise best-practice summaries, alternatives, and tradeoffs.

2. Usage Scenarios

Run before:

  • Using a new API or library.
  • Designing an unfamiliar feature or architecture.
  • Evaluating alternative implementations.

3. Helper Scripts

ScriptPurposeQuick ModeDeep Mode
scripts/gemini_research.shGeneral-purpose quick research.Default--deep
scripts/gemini_research.shDeep research via Google Gemini.--flashDefault

Arguments

  • Provide the research topic as a natural-language sentence.
  • Do not include year numbers; the agent fetches up-to-date data.
  • More context ⇒ better results.

4. Examples

Always start with --flash. If the result doesn't work or if important parts are missing, use --deep to get more information.

gemini_research.sh --flash "Which Python HTTP client libraries support caching headers, and with which backends?"

API Research

perplexity_open_router_research.sh "Write a Python best-practice manual for using the Atlassian Confluence API."
gemini_research "Same as above."
perplexity_open_router_researchi.sh --deep "Give a second opinion on the Atlassian API usage. Alternatives and tradeoffs?"

Library Research

perplexity_open_router_research.sh "Best practices for using the os-lib library in Scala."
gemini_research.sh "Manual for using os-lib in Scala."
perplexity_open_router_research.sh --deep "Second opinion on using os-lib in Scala. Alternatives and tradeoffs?"

Implementation Planning

perplexity_open_router_research.sh "How to parse cron expressions in Rust, using stdlib or third-party crates?"
gemini_research.sh "Manual for parsing cron expressions in Rust with the cron crate."
perplexity_open_router_research.sh --deep "Evaluate the cron crate. Alternatives and tradeoffs?"

5. Tool Modes

OptionDescription
--flashFast, shallow lookup for immediate results.
--deepMulti-step synthesis with broader exploration.
perplexity_open_routerBreadth-first research across multiple sources.
gemini_researchDepth-first synthesis for comprehensive analysis.

6. Fallbacks and Error Handling

If one agent fails, retry with the alternate tool. Ensure network access and required API keys are configured.

7. Output Format

  • Markdown-formatted structured output
  • Sections for: Overview, Best Practices, Alternatives, Tradeoffs
  • Links to primary references where available

8. Comparison Table

ToolScopeDepthResponse Speed
PerplexityBroadMediumFast
GeminiFocusedDeepModerate

9. Exit Codes

CodeMeaning
0Success
1Invalid arguments
2Network or API failure
3Unexpected agent response

10. Environment Variables

VariableDescription
OPENROUTER_API_KEYRequired for Perplexity agent.
GOOGLE_API_KEYRequired for Gemini agent.

11. Troubleshooting

ProblemPossible CauseFix
Error: No response from APIConnectivity issue or invalid keyCheck internet or credentials
Output incompleteTimeout or token limitRetry with --deep
Invalid topic formatMissing sentence structureUse full sentences

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon