Skip to content

adeonir/agent-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

440 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent Skills

A personal collection of skills for AI coding agents. Each skill packages instructions, references, and workflows that extend agent capabilities beyond their defaults.

What are Skills?

Skills are packaged instructions that teach AI agents new workflows and specialized knowledge. Think of them as plugins — a SKILL.md file with YAML frontmatter tells the agent when to activate, and markdown content tells it what to do. Supporting files (references, templates, scripts) are loaded on demand to keep context usage minimal.

Skills follow the Agent Skills open standard, which originated in Claude Code and has been adopted across all major AI coding agents.

Installation

Install any skill with a single command using the Skills CLI:

npx skills add adeonir/agent-skills

Or install a single skill:

npx skills add adeonir/agent-skills/<skill-name>

Skills

Skill Category Description
debug-tools Engineering Iterative investigate–fix–verify debugging with confidence scoring
git-helpers Engineering Conventional commits, pull requests, and branch lifecycle
review-lens Engineering Confidence-scored pre-PR code review in quick and deep modes
rule-creator Engineering Create and manage Claude Code rules in .claude/rules/
spec-driven Engineering Spec-driven feature development with auto-sizing and full traceability
notes Personal Obsidian notes for projects, meetings, challenges, and brag docs
handoff Personal Save and resume conversation state across sessions
wrap-up Personal End-of-session context persistence to Obsidian
blueprint Product Plans blueprint.md — information architecture, layout, and screen flow
brainstorming Product Structured idea exploration and plan stress-testing, diverge to converge
copywriting Product Authors copy.yaml — fresh copy or structured existing content
craft-ui Product Render design variants, critique a variant, audit a running UI — non-mutating
design-brief Product Greenfield visual identity — explore a direction and author DESIGN.md
docs-writer Product Structured docs: PRD, Brief, Design Doc, ADR
epic-tracker Product Epics, stories, bugs, and releases — tracker-first or markdown

How They Connect

flowchart TD
    BR[brainstorming] -->|direction| DW_PRD[docs-writer · product]
    BR -->|direction| DB[design-brief]
    BR -.->|direction| SD[spec-driven]
    DW_PRD -->|requirements| DW_DD[docs-writer · technical]
    DW_PRD -->|requirements| ET[epic-tracker]
    DW_PRD -->|requirements| DB
    DW_PRD -->|requirements| BP[blueprint]
    DW_PRD -->|requirements| CW[copywriting]
    BP -->|layout| CU[craft-ui]
    CW -->|content| CU
    DB -->|tokens| CU
    CU -->|interface| SD
    DW_DD -->|technical doc| SD
    DW_DD -->|technical doc| ET
    DW_DD -->|technical doc| DB
    DW_DD -.->|extract decision| DW_ADR[docs-writer · decision]
    ET -->|stories| SD
    SD -->|commits & pull requests| GH[git-helpers]
    SD -.->|coherence gap| DW_DD
Loading

Dashed arrow: optional shortcut for small, well-scoped work. debug-tools, rule-creator, notes, handoff, and wrap-up are available at any point — utilities and reviews used as needed, not mandatory pipeline stages.

Using the Flow

The full flow when building a new product or feature with non-trivial business logic:

1.  brainstorming --> direction and constraints
2.  docs-writer   --> requirements (what to build, for whom, why)
3.  docs-writer   --> technical decisions and trade-offs
4.  blueprint     --> layout and screen flow
5.  design-brief  --> visual identity and design tokens
6.  copywriting   --> content and copy
7.  craft-ui      --> build and pressure-test the interface
8.  epic-tracker  --> epics, stories, acceptance criteria
9.  spec-driven   --> per-story spec, design, tasks, implementation
10. review-lens   --> review changes before commit
11. git-helpers   --> commit, pull request, finish branch

Feedback loop

spec-driven discovers coherence gaps during implementation and signals back:

spec-driven discovers gap (missing entity, orphan flow, NFR drift)
    --> writes to knowledge.md ## Coherence Gaps
    --> user reruns docs-writer with update mode
    --> docs-writer re-enters the responsible phase scoped to the gap
    --> spec-driven resumes with updated technical doc

Output Structure

docs/
├── product/        # brainstorming: brainstorm · docs-writer: PRD, brief
├── tech/           # docs-writer: design-doc
├── adr/            # docs-writer: append-only decision log
└── design/         # design-brief: visual identity · blueprint: layout · copywriting: content

.artifacts/
├── knowledge.md    # spec-driven: cross-feature decisions, gotchas, conventions
├── codebase/       # spec-driven: area exploration cache (reusable)
├── design/         # design-brief: tune session events · craft-ui: variant HTML
├── epics/          # epic-tracker: epics, stories, bugs, issues, releases
├── features/       # spec-driven: feature specs, designs, tasks
├── quick/          # spec-driven: quick mode tasks
└── research/       # spec-driven: research cache

Skills write to docs/ (committed, human-facing) and .artifacts/ (gitignored agent workspace).

License

MIT

About

A personal collection of skills for AI coding agents

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors