reference

zph's avatarfrom zph

Research reference material from URLs and create comprehensive documentation. Use this skill when users provide URLs to research, need to gather and synthesize information from web sources, or want to create structured research documentation with citations and summaries.

⭐21stars🔀4forks📁View on GitHub🕐Updated Jan 7, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the process of gathering and synthesizing information from the web. It extracts content from provided URLs, converts it into clean markdown format, and organizes it into a structured knowledge base. By generating comprehensive README documentation with citations and key findings, it transforms raw web data into professional-grade research reports.

Use Cases

  • Technical Documentation: Researching multiple programming guides or API documentation to create a unified, internal technical reference guide.
  • Market & Competitive Analysis: Gathering and synthesizing industry news, competitor blog posts, and market reports into a structured research folder for business strategy.
  • Academic & Literature Review: Collecting online articles and papers to generate a summarized knowledge base with proper citations for study or writing projects.
  • Content Archiving: Converting web-based resources into a clean, local markdown format for long-term knowledge management and offline reference.
namereference
descriptionResearch reference material from URLs and create comprehensive documentation. Use this skill when users provide URLs to research, need to gather and synthesize information from web sources, or want to create structured research documentation with citations and summaries.

Reference Material Research Skill

You are tasked with researching reference material provided by the user and creating comprehensive documentation.

Input

The user will provide a description that may contain one or more URLs to research.

Process

1. Setup url-to-md tool (if not already installed)

Check if url-to-md is available, and if not, install it:

deno install -A --global -n url-to-md https://raw.githubusercontent.com/zph/url-to-md/refs/heads/main/url-to-md.ts

2. Extract and Process URLs

  • Identify all direct URLs in the user's description
  • For each URL, use url-to-md to download and convert the content to markdown
  • Save each article to docs/research/<descriptive-task-name>/ with a descriptive filename based on the article title or URL
  • Use the format: <article-name>.md

3. Supplementary Research

  • Use WebSearch or WebFetch to gather additional context if needed
  • Ensure you understand the topic comprehensively

4. Create Summary Documentation

Create a README.md in docs/research/<descriptive-task-name>/ that includes:

Structure:

# [Descriptive Task Name]

## Overview
Brief introduction to the research topic and purpose.

## Key Findings
Summarize the main insights from all sources.

## Sources

### [Article 1 Title]
**Source:** [URL]
**Saved as:** `article-1.md`

[2-3 paragraph summary of key points]

Key takeaways:
- Bullet point 1
- Bullet point 2
- Bullet point 3

### [Article 2 Title]
**Source:** [URL]
**Saved as:** `article-2.md`

[Summary continues...]

## References
1. [Author/Site Name]. "[Article Title]". [URL]. Retrieved [Date].
2. [Continue with all sources...]

## Related Topics
- Topic 1
- Topic 2

## Additional Notes
Any supplementary insights or connections between sources.

Important Guidelines

  1. Citations: Use proper markdown citation format throughout
  2. File naming: Use descriptive, kebab-case names for files
  3. Organization: Each research session gets its own folder under docs/research/
  4. Content preservation: Keep the full url-to-md output in individual files
  5. Summary quality: README.md should synthesize information, not just list it
  6. Cross-references: Link between related concepts when applicable

Example Workflow

If user says: "Research these articles on Rust async patterns: https://example.com/rust-async, https://example.com/tokio-guide"

  1. Create docs/research/rust-async-patterns/
  2. Download:
    • rust-async.md (from first URL)
    • tokio-guide.md (from second URL)
  3. Create README.md with synthesis of both articles, proper citations, and key insights

Output

After completing the research:

  1. Confirm all URLs were processed successfully
  2. Provide the path to the research folder
  3. Give a brief summary of what was learned
  4. Ask if the user wants any specific aspects explored further