Agent Skills

A curated collection of Agent Skills for Agentic Software Delivery, following the SKILL.md Specification.

Overview

This repository provides reusable skill modules that enhance AI coding agents with domain-specific knowledge, best practices, and automation scripts. Each skill contains documentation, scripts, references, and assets to help you implement specific functionalities in your agentic software delivery projects.

Installation

Quick install (download and run)

Download and run the install script directly from GitHub (clones the repo to ~/.deerhide/repositories/agent_skills, copies skills to ~/.claude/skills and agents to ~/.claude/agents, and adds the deerhide_agents_skills_update alias to your shell rc):

curl -fsSL https://raw.githubusercontent.com/DeerHide/agent_skills/main/scripts/install_or_update.sh | bash

Afterwards you can update skills and agents anytime with:

deerhide_agents_skills_update

Installed paths:

• Skills: ~/.claude/skills — one directory per skill (e.g. git, python-architecture).
• Agents: ~/.claude/agents — agent definition files (e.g. Analyst — analyst.md for epics and user stories; Developper — developper.md for story-driven feature implementation from story to PR).

Available Skills

Skill	Description
commit	Prepare logical commits, Conventional Commit messages, and Unreleased changelog updates
fastapi-factory-utilities	Build FastAPI microservices with plugins, typed query filters, PUT reconciliation, audit publishing, Uvicorn/Hypercorn ASGI servers, OAuth2/OIDC, OpenTelemetry, and CSRF & validation handlers
git	Git commit conventions, branch naming, semantic versioning, changelog maintenance, and pre-commit hooks
http-api-architecture	REST API design patterns, caching strategies, distributed tracing, OAuth2/OIDC flows, and webhook security
jira-cli	Interact with Jira from the command line using ankitpokhrel/jira-cli (create, update, list, link, comment)
jira-epics-stories	Writing epics and user stories with acceptance criteria; creating or updating them in Jira via jira-cli
openapi	OpenAPI 3.1 specification design, validation with Spectral, and best practices
openapi-testing	API testing with Portman and Newman for contract testing
python	Python engineering principles, coding standards, typing, async patterns, testing, and documentation
python-architecture	Clean architecture patterns for Python/FastAPI services with Poetry and Cloud Native Buildpacks
python-docstring	Python documentation standards and docstring conventions
python-lint	Python linting configuration with Pylint and code quality tools
python-test	Python testing with pytest, fixtures, mocks, and Testcontainers
release	Release workflow: changelog, git state, atomic commits, SemVer, and annotated tags
software-architecture	Clean Architecture, DDD, SOLID principles, and microservices patterns
story-driven-development	Feature implementation from user story through branch, scenarios, contract, TDD, quality gate, commit, and PR
velmios-lib	Velmios Core types, lite entities, composable permissions, use-case abstracts, realm-aware audit events, feature flags, application scaffolding, and centralized security exception handling with telemetry
velmios-projects	Catalog of Velmios-related projects with absolute paths and summaries for cross-project discovery
writing-skills	How to write Agent Skills: structure, descriptions, natural language strength (MUST/SHOULD/MAY), and checklists

Skill Structure

Each skill follows a consistent structure:

skills/<skill-name>/
├── SKILL.md          # Main skill documentation with metadata and instructions
├── assets/           # Static files, templates, and configuration examples
├── references/       # Detailed reference documentation and guides
└── scripts/          # Automation scripts for setup and execution

Usage

With AI Coding Agents

Reference the skill in your agent's context or instructions:

Use the skills from https://github.com/DeerHide/agent_skills for:
- Git conventions: skills/git/SKILL.md
- Python architecture: skills/python-architecture/SKILL.md

Manual Reference

Browse the skill documentation directly for best practices and implementation guides.

Creating New Skills

Use the template as a starting point:

1. Copy the template/ directory
2. Rename it to your skill name
3. Update SKILL.md with your skill's metadata and documentation
4. Add assets, references, and scripts as needed

Contributing

Contributions are welcome! Please ensure your skills follow the established structure and include comprehensive documentation.

Authors & Maintainers

• DeerHide - Initial work & maintenance - @DeerHide

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ by DeerHide