3.8 KiB
name, description
| name | description |
|---|---|
| enrich-citations | Add authoritative source links for all facts, citations, and references in markdown content |
Process markdown content and enrich it with authoritative citation links:
<input_markdown_content> $ARGUMENTS </input_markdown_content>
Input Processing
The command accepts ARGUMENTS which can be either:
-
Absolute file path: If the ARGUMENTS starts with
/, treat it as a file path- Read the markdown content from the specified file
- Example:
/enrich-citations /Users/sanhehu/Documents/article.md
-
Inline content: If ARGUMENTS is not an absolute path, treat it as inline markdown text
- Process the text directly
- Example:
/enrich-citations This article mentions React and TypeScript frameworks.
Workflow
1. Load Content
- If absolute path provided: Read content from file
- If inline content provided: Use the provided text directly
2. Enrich Citations
Use the enrich-citations agent skill to process the markdown content:
Identify all references:
- External sources and research papers
- Tools, software, frameworks, libraries
- Products and services
- Organizations and institutions
- Technical concepts and standards
- People and experts
For each identified reference:
- Perform web search to find the authoritative source
- Verify the URL is current and accessible
- Replace plain text with markdown hyperlinks:
[Reference](URL) - Add spaces around hyperlinks:
text [link](url) text
Citation priority:
- Official sources (project homepages, official documentation)
- Primary sources (original research papers, publications)
- Authoritative organizations (standards bodies, academic institutions)
- Reputable publications (tech blogs, news sites)
- Community resources (GitHub, Stack Overflow)
- General references (Wikipedia as last resort)
Quality requirements:
- Verify all links are valid and working
- Ensure proper markdown formatting with spaces
- Preserve all original content (only add hyperlinks)
- Maintain document structure and meaning
3. Save Output
Save the enriched document to: ~/tmp/citation_enriched.md
Example enrichment:
Input:
# Introduction to Modern JavaScript
JavaScript has evolved significantly with ES6 introducing features like arrow functions.
TypeScript adds static typing to JavaScript and is developed by Microsoft.
Output:
# Introduction to Modern JavaScript
[JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript) has evolved significantly with [ES6](https://www.ecma-international.org/ecma-262/6.0/) introducing features like arrow functions.
[TypeScript](https://www.typescriptlang.org/) adds static typing to JavaScript and is developed by [Microsoft](https://www.microsoft.com/) .
4. Display Output Location
After completing the enrichment and saving the document, print the absolute path in a clickable format.
Format: file:///absolute/path/to/citation_enriched.md
Example output:
✓ Citation enrichment completed successfully!
✓ Enriched document saved to: file:///Users/sanhehu/tmp/citation_enriched.md
Click the link above to open the document.
Requirements:
- Use absolute path (not relative path like
~/tmp/...) - Include
file://protocol prefix for clickability - Provide clear success message
- Make it easy for user to access the enriched document
Usage Examples
Enrich an existing file:
/enrich-citations /Users/sanhehu/Documents/article.md
Enrich inline content:
/enrich-citations This article discusses React, Next.js, and Vercel deployment.
Note: This command makes citation enrichment quick and accessible. It automatically performs web searches to find authoritative sources and adds verified hyperlinks to the document.