ResearchSpace

A curated collection of Cursor AI Skills for academic research and paper management. These skills work automatically with Cursor AI agents to help you organize, read, and track research papers.

🎯 What is ResearchSpace?

ResearchSpace provides AI-ready tools for researchers using Cursor IDE. Instead of running scripts manually, you interact naturally with Cursor AI agents, and they use these skills automatically.

Example interactions:

• "Add this paper: https://arxiv.org/abs/1706.03762"
• "Create a reading plan for the Attention Is All You Need paper"
• "I finished reading the introduction, mark it complete"
• "Show me my reading progress dashboard"
• "Show me all papers tagged with transformers"

🚀 Quick Start

Install Skills (Recommended)

Use the skills CLI to install ResearchSpace skills:

# Cursor — all projects
npx skills add lym29/ResearchSpace -a cursor -g

# Claude Code — all projects
npx skills add lym29/ResearchSpace -a claude-code -g

For a single project only, omit -g:

npx skills add lym29/ResearchSpace -a cursor
npx skills add lym29/ResearchSpace -a claude-code

Skills are installed to ~/.cursor/skills/ (Cursor) or ~/.claude/skills/ (Claude Code) when using -g.

Clone for Development

git clone https://github.com/lym29/ResearchSpace.git
cd ResearchSpace

Open the folder in Cursor to contribute or customize skills. To use them locally while developing, run npx skills add . -a cursor from the repo root.

📚 Available Skills

Paper Management (paper-management)

Complete research paper management with reading plans and progress tracking.

Features:

• 📄 Paper Organization: Fetch metadata from arXiv, HuggingFace, BibTeX
• 🏷️ Smart Tagging: Auto-suggests relevant tags based on content
• 📋 Reading Lists: Manage papers with priorities (high/medium/low)
• ✅ TODO Lists: Create structured reading plans for each paper
• 📊 Progress Tracking: Track completion of reading tasks
• 🎨 Visual Dashboard: Generate beautiful HTML dashboard of your progress

Sources supported:

• arXiv URLs or IDs
• HuggingFace paper pages
• BibTeX citations
• Paper names (searches automatically)

Example usage with Cursor AI:

• "Add the Attention Is All You Need paper to my reading list"
• "I need to read https://arxiv.org/abs/2303.08774, mark it as high priority"
• "Create a TODO list for studying the Transformer paper"
• "I finished reading the introduction, mark it complete"
• "Generate a dashboard to see my reading progress"

→ View full skill documentation

🏗️ Repository Structure

ResearchSpace/
├── skills/
│   └── paper-management/          # Paper management skill
│       ├── SKILL.md               # Skill definition (auto-loaded by agents)
│       ├── scripts/               # Implementation
│       └── references/            # Detailed documentation
├── README.md                      # This file
└── ROADMAP.md                     # Future skills and features

🔒 Data Privacy

Your research data is yours alone. We recommend:

• Store data in a private Git repository (separate from this public skills repo)
• Install skills with npx skills add lym29/ResearchSpace or clone ResearchSpace for development (see Quick Start above)
• Add data directories to your .gitignore if you don't want to version them

→ View skill documentation

💡 How Cursor Skills Work

1. Automatic Discovery: Agents scan their skills directories (e.g. ~/.cursor/skills/ for Cursor, ~/.claude/skills/ for Claude Code)
2. Context-Aware: Skills activate automatically based on your conversation
3. Natural Language: Just describe what you want - the AI handles the rest
4. No Manual Setup: Skills work immediately, no installation required

🎓 For Developers

Using Skills Programmatically

While skills are designed for AI agents, you can also use them directly:

import sys
sys.path.insert(0, 'skills/paper-management/scripts')

from paper_skill import add_paper_auto

result = add_paper_auto("https://arxiv.org/abs/1706.03762", priority="high")
print(f"Added: {result['paper']['title']}")

CLI Access

python skills/paper-management/scripts/research.py papers add "https://arxiv.org/abs/1706.03762"

🗺️ Roadmap

Planned skills for researchers:

• Note-taking and Annotation: AI-assisted paper notes and highlights
• Citation Management: Bibliography generation and citation tracking
• Literature Review: Automated literature mapping and gap analysis
• Research Analytics: Reading patterns and topic clustering
• Collaboration: Share reading lists and notes with team members

→ View detailed roadmap

🤝 Contributing

ResearchSpace is designed to grow with the research community:

• Add new skills: Create skills for your research workflow
• Improve existing skills: Enhance paper management features
• Share feedback: Report issues or suggest improvements

Each skill is modular and independent, making it easy to contribute!

📖 Learn More

• Paper Management Skill Documentation
• API Reference
• Cursor Skills Documentation

📄 License

MIT License - Feel free to use and adapt for your research needs!

---

Built for researchers using Cursor AI 🔬 + 🤖