CtrlK
BlogDocsLog inGet started
Tessl Logo

google-gemini-file-search

Google Gemini File Search for managed RAG with 100+ file formats. Use for document Q&A, knowledge bases, or encountering immutability errors, quota issues, polling failures. Supports Gemini 3 Pro/Flash (Gemini 2.5 legacy).

90

2.20x
Quality

87%

Does it follow best practices?

Impact

95%

2.20x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description with excellent trigger terms and completeness. It clearly identifies the Google Gemini ecosystem and includes both use cases and troubleshooting scenarios. The main weakness is that the specific capabilities could be more concrete - listing actual actions rather than just categories like 'document Q&A'.

Suggestions

Add 2-3 specific concrete actions like 'upload documents to corpora', 'query indexed files', or 'manage file metadata' to improve specificity

DimensionReasoningScore

Specificity

Names the domain (Google Gemini File Search, managed RAG) and mentions some actions (document Q&A, knowledge bases), but doesn't list multiple concrete actions like 'upload files', 'query documents', or 'create knowledge bases'.

2 / 3

Completeness

Clearly answers both what (Google Gemini File Search for managed RAG with 100+ file formats) and when (Use for document Q&A, knowledge bases, or encountering specific error types), with explicit 'Use for' trigger guidance.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'document Q&A', 'knowledge bases', 'Gemini', 'RAG', plus specific error scenarios ('immutability errors', 'quota issues', 'polling failures') and model names that users might reference.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with specific platform (Google Gemini), specific feature (File Search), and unique error scenarios that clearly differentiate it from generic document or RAG skills.

3 / 3

Total

11

/

12

Passed

Implementation

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, production-ready skill with excellent actionability and workflow clarity. The code examples are complete and executable, error handling patterns are well-documented with prevention strategies, and the progressive disclosure structure is exemplary. The main weakness is some redundancy between the 'Critical Rules' section and the error examples, plus the Always/Never lists being mirror images.

Suggestions

Consolidate the 'Always Do/Never Do' lists into a single concise checklist to reduce redundancy

Trim the 'What Is File Search' comparison section - Claude doesn't need the detailed comparison to understand when to use this skill

DimensionReasoningScore

Conciseness

The skill is mostly efficient but includes some redundancy - the 'Critical Rules' section duplicates information found in the error examples, and the 'Always Do/Never Do' lists are somewhat repetitive mirror images of each other. The comparison to alternatives and 'What Is File Search' section could be trimmed.

2 / 3

Actionability

Excellent executable code examples throughout - complete TypeScript snippets for store creation, document upload, polling, querying, and error handling patterns. All code is copy-paste ready with proper imports and realistic usage.

3 / 3

Workflow Clarity

Clear multi-step workflows with explicit validation checkpoints - the document update flow shows numbered steps with polling until done, the batch upload pattern includes operation polling, and the 'Top 3 Errors Prevented' section provides clear feedback loops for common failure modes.

3 / 3

Progressive Disclosure

Well-structured with clear overview and one-level-deep references. The 'When to Load References' section explicitly guides when to access setup-guide.md and error-catalog.md. Content is appropriately split between quick start, patterns, and detailed reference files.

3 / 3

Total

11

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

Passed

Repository
secondsky/claude-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.