Software Engineer

This is a solid foundation for writing clean, maintainable code without the usual cruft. It pushes you toward self-documenting code over comment noise, stops you from littering the codebase with TODOs, and enforces a fact-based approach where you search for answers instead of guessing. The workflow detection is smart: it'll check for spec-first or TDD patterns and follow what's already there. It also blocks destructive git commands by default and makes you pause before reaching for type suppressions or `any` types. The stance on backward compatibility is refreshingly pragmatic: only worry about it for public APIs, let tests catch everything else. If you're tired of repositories that look like drafts, this brings some discipline.

skills.sh installs: 631
GitHub stars: 22
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add siviter-xyz/dot-agent --skill software-engineer --agent claude-code

Installs into .claude/skills of the current project.

Files

Software Engineering Principles

Core principles and preferences for code style, documentation, and development workflow.

Code Style and Patterns

Avoid unnecessary comments: Code should be self-documenting. Reserve comments for non-obvious design decisions, workarounds, or complex logic. Avoid comments that restate what the code obviously does.
Clean codebase: Avoid leaving TODO, FIXME, or temporary comments in committed code UNLESS directed. Either implement the feature, create an issue, or remove the comment. Ignore existing ones.
Self-documenting code: Prefer clear naming and structure over explanatory comments. Method, class, and member documentation should use language/stack best practices. Don't add useless inline comments next to statements UNLESS they explain confusing or complex behaviour.

Documentation

Concise and useful: Documentation should be informative but not verbose. READMEs should focus on essential information without unnecessary elaboration.
Structure over verbosity: Prefer well-organized, scannable documentation with clear headings over long paragraphs. Use short examples to illustrate concepts.

SKILL.md on GitHub