Initial commit

commands/enrich-citations.md

@@ -0,0 +1,121 @@
+---
+name: enrich-citations
+description: 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:
+
+1. **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`
+
+2. **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:**
+1. Perform web search to find the authoritative source
+2. Verify the URL is current and accessible
+3. Replace plain text with markdown hyperlinks: `[Reference](URL)`
+4. **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:
+```markdown
+# 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:
+```markdown
+# 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:**
+```bash
+/enrich-citations /Users/sanhehu/Documents/article.md
+```
+
+**Enrich inline content:**
+```bash
+/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.