Update README with skill catalog and repo description

2026-03-03 16:59:15 +01:00
parent 7cee562c02
commit 9d8e0e1024
1 changed files with 21 additions and 1 deletions
@@ -1,3 +1,23 @@
 # skills-software-development
-Skills for the Software Development process
+Reusable AI skills for software development workflows. These skills can be synced into any project to give AI coding assistants (Claude Code, Cursor, etc.) structured guidance for common development tasks.
 ## Available Skills
 | Skill | Description |
 |---|---|
 | [code-review](code-review/) | Critical code review of uncommitted changes, checking for simplicity, dead code, scope creep, bugs, and completeness |
 | [code-self-review](code-self-review/) | Self-review after writing code — step back and critically evaluate your own work |
 | [code-cleanup](code-cleanup/) | Garbage collection for codebases — remove dead code, find duplication, reduce complexity, clean up stale comments |
 | [security-review](security-review/) | Security review from a pentester perspective — injection, auth, data exposure, input handling, misconfigurations |
 | [create-merge-request](create-merge-request/) | Create a GitLab Merge Request from uncommitted changes with proper branching and commit organization |
 | [understand-project](understand-project/) | Learn about a project from its docs, README, and structure before starting work |
 | [figma](figma/) | Fetch Figma design specs for pixel-perfect implementation (includes Node.js tool scripts) |
 ## Structure
 Each skill is a directory containing:
 - `SKILL.md` — the skill definition (frontmatter + instructions)
 - `scripts/` — optional tool scripts used by the skill
 - `README.md` — optional setup instructions (e.g. API keys)