This skill helps maintain the content/technologies directory by researching, validating, and creating technology profiles.
When the user asks to add or check a technology (e.g., "Add Bun", "Check Kubernetes"), follow this process:
- Research & Discovery
Use WebSearch to gather the following information about the technology:
-
Official Name and Description (1-2 paragraphs summary).
-
Official Website and Documentation URLs.
-
Source Code Repository (GitHub/GitLab) and License (e.g., Apache-2.0, MIT).
-
Logos: Look for official vector logos (SVG preferred). You will need paths for icon , horizontal , and stacked . (Note: You won't be able to download them directly to the specific filenames without FetchUrl or curl , so for now, just identify if they exist or create placeholders).
-
Key Features: What are the main selling points?
-
Use Cases: When should someone use this?
-
Core Concepts: What are the main building blocks?
-
Ecosystem: Related tools or integrations.
- Check Existence
Check if content/technologies/<slug> exists. The slug should be the kebab-case version of the technology name.
- Action: Create New (If it doesn't exist)
-
Create the directory: content/technologies/<slug> .
-
Create index.mdx with the following structure. Strictly follow the frontmatter format.
name: "Technology Name" description: | A comprehensive description of the technology. It can span multiple lines. logos: icon: ./icon.svg horizontal: ./horizontal.svg stacked: ./stacked.svg website: "https://official-website.com" documentation: "https://docs.url" license: "License-Type" categories:
- "category-1"
- "category-2" status: "sandbox" # Default to sandbox for new entries, or 'stable' if very mature radar: status: assess # Default to assess
Introduction paragraph...
What is [Technology]?
...
Why [Technology] Matters in 2025
...
Core [Technology] Concepts
...
Getting Started with [Technology]
...
Common Use Cases
...
Best Practices for Production
...
[Technology] Ecosystem and Tools
...
Conclusion
...
- Logos: Since you cannot browse the web visually to pick the perfect SVG, leave the references in the frontmatter as ./icon.svg , etc., but explicitly tell the user "I have created the file structure. You will need to manually add the icon.svg , horizontal.svg , and stacked.svg files to the content/technologies/<slug> directory."
- Action: Validate & Update (If it exists)
-
Read the existing index.mdx .
-
Compare the website , documentation , and license fields with your research.
-
If they differ, update them.
-
Check if the content is outdated (e.g., refers to old versions or years). If so, propose updates to the "Why it matters" or "What is" sections.
-
Report back to the user with a summary of what was validated and what was updated.
General Guidelines
-
Tone: informative, technical, and objective.
-
Formatting: Use proper Markdown.
-
Files: Do not create other files unless specifically asked.