Skip to content

Sherlock AI plugin; Research & Implementation Supercharged with a curated list of AI skills

Notifications You must be signed in to change notification settings

proyecto26/sherlock-ai-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ•΅οΈβ€β™‚οΈ Sherlock AI Plugin

Paper to Comics

The Ultimate Research & Implementation Assistant for Claude Code & Cursor

Sherlock is a curated collection of high-powered AI skills designed to transform your research workflow. It doesn't just read papersβ€”it deduces, visualizes, and reconstructs them into working code.

From deep-diving into literature to converting methodology into Python, Sherlock equips your AI agent with the tools of a master detective and a master engineer.

🧰 The Essentials Kit (Features)

Sherlock equips your agent with these specialized skills:

🧩 1. Paper2Code (The Engineer)

Transforms academic theory into executable reality.

  • 4-Stage Pipeline: Systematically converts research papers into code (Algorithm Extraction β†’ Concept Analysis β†’ Planning β†’ Implementation).
  • No Hallucinations: Forces a structured intermediate representation (YAML) before writing a single line of code.
  • Reproducibility First: Prioritizes accuracy and paper fidelity over "clever" coding.

πŸ“š 2. Deep Research (The Detective)

The heavy lifter for comprehensive reports.

  • Multi-Pass Drafting: Spawns parallel sub-agents to draft different sections of a report.
  • Evidence Tracking: Maintains strictly cited evidence tablesβ€”no claim goes unsourced.
  • High Fidelity: Produces professional-grade reports with strict formatting compliance.

🎨 3. Paper Comic (The Storyteller)

Explains the unexplainable through visual narratives.

  • Visual Translation: Turns dense academic text into educational comics.
  • Style Adaptive: Choose from Classic, Tech/Futuristic, Warm, or Chalkboard art styles.
  • Gemini Powered: Uses the genimg-gemini-web skill for consistent character consistency across panels.

πŸ”¬ 4. Paper Analyzer (The Analyst)

X-Ray vision for PDFs.

  • MinerU Integration: High-precision parsing of formulas, tables, and latex from PDFs.
  • Style Rewrite: Can rewrite complex papers into "Storytelling", "Academic", or "Concise" formats.
  • Metadata Extraction: Automatically pulls title, authors, and citations.

πŸ–ΌοΈ 5. GenImg Gemini Web (The Artist)

The visual engine.

  • Image Generation: Generates images via Google's Gemini Web.
  • Multi-Modal: Handles text-to-image and image-to-text tasks.
  • Session Awareness: Maintains context across multi-turn conversations for consistent output.

πŸ“ 6. Visual Architect (The Designer)

Blueprints for understanding.

  • Schema Generation: Transforms methodology sections into structural visual schemas.
  • Prompt Engineering: Generates high-precision prompts for DALL-E 3 or Midjourney based on paper logic.
  • Layout Logic: Detects if a system is Linear, Cyclic, Hierarchical, or Parallel.

πŸš€ Quick Start

Installation

  1. Clone the Repository

    git clone https://github.com/proyecto26/research-skills.git .claude
    
  2. Configure .claude/config.json (Optional but Recommended) Ensure your skills are registered with your agent runtime (Claude Code / Cursor MCP).

  3. Authentication Some skills (like genimg-gemini-web and paper-analyzer) require API tokens or login sessions.

    • Gemini: Run npx -y bun .claude/skills/genimg-gemini-web/scripts/main.ts --login
    • MinerU: Export MINERU_TOKEN in your environment.

Usage Examples

"Sherlock, implement this paper for me."

Triggers Paper2Code to read the PDF, plan the architecture, and write the Python implementation.

"Sherlock, explain this complex transformer architecture as a comic."

Triggers Paper Comic to create a visual storyboard explaining the concept.

"Sherlock, I need a deep research report on the state of LLM reasoning."

Triggers Deep Research to crawl, analyze, and compile a multi-page cited report.

"Sherlock, visualize the flow of data in this system."

Triggers Visual Architect to design a schematic diagram prompt.


πŸ“‚ Structure

skills/
β”œβ”€β”€ deep-research/       # Report generation & evidence tracking
β”œβ”€β”€ paper2code/          # Paper implementation pipeline
β”œβ”€β”€ paper-comic/         # Educational comic generator
β”œβ”€β”€ paper-analyzer/      # PDF parsing & style rewriting
β”œβ”€β”€ genimg-gemini-web/   # Image generation backend
└── visual-architect/    # Visual schema design

🀝 Contribution

Sherlock learns from the community. If you have a new skill module or an improvement to an existing detective tool, please open a PR!

Credits

Happy coding πŸ’―

Made with ❀️