Ask HN: How do you manage skills files?
-
Core Inquiry:
- The author asks how developers find, organize, validate, and maintain agent "skill files" over time, wondering if advancing foundation model capabilities will soon make them obsolete.
-
Rejection of Public Skill Collections:
- A dominant sentiment warns against hoarding third-party skills, comparing public repositories to unread bookmarks or digital clutter.
- Bloating context with generic skills often provides zero benefit, distracts the model, and wastes input tokens.
-
Best Practices for Skill Management:
- Custom and Workflow-Specific: High-value skills are typically authored from scratch to codify personal taste, team conventions, or internal tools (e.g., specific VCS workflows, subagent review priorities, output sanitization).
- Version Control and Symlinks: Practitioners keep skills version-controlled in a dedicated Git repository and symlink that folder into respective agent directories across machines and projects.
- Audit and Maintenance Tracking: Some maintain tracking files (e.g., Markdown tables) recording each skill's description, last edit, execution recency, and logged exceptions.
-
Key Value Propositions:
- Token Efficiency & Speed: Skills eliminate repetitive exploration, preventing agents from "trial-and-erroring" through ten locations to complete standard workflows.
- Deterministic Automation: Pairing prompt instructions with local scripts or CLI tools allows deterministic context gathering and execution without relying entirely on non-deterministic tool-calling loops.
- Institutional Knowledge: They act as codified SOPs for domain-specific or proprietary systems not present in public LLM training data.
- Raising the Floor: Standardized skills help non-expert team members run consistent reviews, enforce security practices, or execute complex workflows without advanced prompting skills.
-
Skeptical Counterpoints:
- Some developers view excessive skills as a code smell or modern "snake oil," arguing that modern reasoning models paired with clear repositories and direct prompts can determine what to do without external macro files.