tech — Categories.community

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:

1. 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.

2. Check Existence

Check if content/technologies/<slug> exists. The slug should be the kebab-case version of the technology name.

3. Action: Create New (If it doesn't exist)

1. Create the directory: content/technologies/<slug>.
2. Create index.mdx with the following structure. Strictly follow the frontmatter format.

yaml
1---
2name: "Technology Name"
3description: |
4  A comprehensive description of the technology.
5  It can span multiple lines.
6logos:
7  icon: ./icon.svg
8  horizontal: ./horizontal.svg
9  stacked: ./stacked.svg
10website: "https://official-website.com"
11documentation: "https://docs.url"
12license: "License-Type"
13categories:
14  - "category-1"
15  - "category-2"
16status: "sandbox" # Default to sandbox for new entries, or 'stable' if very mature
17radar:
18  status: assess # Default to assess
19---
20
21Introduction paragraph...
22
23## What is [Technology]?
24...
25
26## Why [Technology] Matters in 2025
27...
28
29## Core [Technology] Concepts
30...
31
32## Getting Started with [Technology]
33...
34
35## Common Use Cases
36...
37
38## Best Practices for Production
39...
40
41## [Technology] Ecosystem and Tools
42...
43
44## Conclusion
45...

3. 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."

4. Action: Validate & Update (If it exists)

1. Read the existing index.mdx.
2. Compare the website, documentation, and license fields with your research.
3. If they differ, update them.
4. 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.
5. 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.