xonecas.io
56101
Df

dotfiles / commit 69d05bc

docs: enhance skill descriptions and add code quality guidelines

xonecas2026-01-29 69d05bc459ed6fcae9f25f4328e844702c711630 parent a764e25

3 files changed

opencode/AGENTS.md+4−0
@@ -27,3 +27,7 @@ Load and apply the `token-efficiency-opencode` skill to minimize token usage.
2727 # Programming principles
2828
2929 When designing, refactoring, editing, adding, or reviewing code, load and apply the `good-programming-principles` skill. Use it to keep solutions simple, scoped, and maintainable.
30+
31+Comments should only be used when the code can't be self explanatory.
32+
33+We don't leave TODO comments or any other sort of pending work.
opencode/skills/good-programming-principles/SKILL.md+2−2
@@ -1,7 +1,7 @@
11 ---
22 name: good-programming-principles
3-description: Practical principles for simple, maintainable, resilient code.
4-version: 0.0.0
3+description: Load when designing, writing, editing, refactoring, or reviewing code. Applies KISS, DRY, YAGNI, and SOLID principles to keep solutions simple, scoped, and maintainable while avoiding overengineering.
4+version: 0.0.1
55 ---
66
77 # Good Programming Principles
opencode/skills/token-efficiency-opencode/SKILL.md+1−1
@@ -1,6 +1,6 @@
11 ---
22 name: token-efficiency-opencode
3-description: Token optimization best practices for cost-effective agent usage.
3+description: Load before any file operation, codebase exploration, or task involving large outputs. Provides strategies to minimize token usage by 90%+ through smart filtering, parallel calls, and avoiding full file reads.
44 version: 0.0.0
55 ---