Skip to content

durandom/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

186 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧠 durandom-skills

πŸš€ A collection of Claude Code skills, agents, commands, and recipes to supercharge your productivity!


✨ What's Inside?

This repository contains reusable skills and patterns for Claude Code that help with:

Component Description
πŸ—ΊοΈ Code Mapping Navigate codebases like a pro with hierarchical documentation
βœ… GTD Getting Things Done task management via CLI
πŸ“‚ PARA Organize notes by actionability (Projects/Areas/Resources/Archive)
πŸ™ GitHub GitHub CLI operations for issues, PRs, reviews, and CI
πŸ•·οΈ crawl4ai Web crawling and data extraction via crwl CLI
πŸ“ Meeting Notes Sync meeting transcripts from Google Calendar + Gemini
πŸ“– Recipes Reusable patterns and guides for AI-assisted development
⚑ Commands Slash commands like /commit, /catchup, /research

πŸ—‚οΈ Skills

πŸ—ΊοΈ Code Mapping

"Where is this thing? What does this do?" β€” Every developer, ever

Hierarchical documentation with 4 zoom levels:

Level Purpose Example
πŸ“‹ L0 System overview Architecture, entry points
🏘️ L1 Domain modules auth/, api/, core/
πŸ“¦ L2 Individual modules Classes, key functions
πŸ” L3 Source code The actual code

Quick Start:

# πŸ”§ Generate code maps from source
uv run python skills/code/code-mapping/scripts/code_map.py generate src/ docs/map/

# βœ… Validate existing maps
uv run python skills/code/code-mapping/scripts/code_map.py validate docs/map/

πŸ“š Full Documentation β†’


βœ… GTD (Getting Things Done)

🧘 "Mind like water" β€” David Allen

A CLI-based task management system following the GTD methodology:

πŸ“₯ Capture β†’ πŸ” Clarify β†’ πŸ—‚οΈ Organize β†’ πŸ”„ Reflect β†’ ▢️ Engage

Features:

  • 🏷️ 12 Fixed Labels β€” context, energy, status, horizon
  • 🎯 6 Horizons of Focus β€” from actions to life purpose
  • πŸ“† Review Workflows β€” daily, weekly, quarterly, yearly
  • πŸ™ GitHub Backend β€” issues as your task store

Quick Start:

# πŸ“₯ Capture a new task
./skills/knowledge/gtd/scripts/gtd capture "Review PR #42"

# πŸ“‹ List tasks by context
./skills/knowledge/gtd/scripts/gtd list --context focus --energy high

# πŸŒ… Start your daily review
./skills/knowledge/gtd/scripts/gtd daily

πŸ“š Full Documentation β†’


πŸ“‚ PARA

πŸ—‚οΈ Organize by actionability, not topic

The PARA method for organizing notes into four categories based on when you'll need them:

Category Purpose
πŸ“ Projects Active goals with deadlines
πŸ”„ Areas Ongoing responsibilities
πŸ“š Resources Topics of interest
πŸ—„οΈ Archive Inactive items

Standalone knowledge organization with CLI for project management, folder structure, and archiving.

πŸ“š Full Documentation β†’


πŸ™ GitHub

πŸ”§ Unified interface for GitHub operations

GitHub CLI operations using gh:

  • πŸ“‹ Issue Triage β€” prioritize and label issues
  • πŸ” PR Review β€” review workflows and checklists
  • πŸš€ CI Monitoring β€” check pipeline status
  • πŸ€– Copilot Iteration β€” track Copilot-assisted workflows

πŸ“š Full Documentation β†’


πŸ•·οΈ crawl4ai

🌐 Extract web content as clean markdown

Web crawling and data extraction using the crwl CLI. Handles static sites, JavaScript-rendered SPAs, and structured data extraction.

πŸ“š Full Documentation β†’


πŸ“ Meeting Notes

πŸŽ™οΈ Sync and manage meeting transcripts

Syncs Google Calendar meetings with Gemini transcripts, organizing them into a meetings directory with tag-based categorization.

πŸ“š Full Documentation β†’


⚑ Commands

/commit πŸ“

Smart git commits with emoji conventional format:

/commit          # πŸ”„ Stage all, run hooks, commit
/commit staged   # πŸ“‹ Only commit staged changes
/commit amend    # ✏️ Fix the last commit
/commit split    # πŸ”€ Interactive multi-commit
/commit dry-run  # πŸ‘€ Preview without committing

/catchup πŸ”„

Session restart orientation:

/catchup         # πŸ“Š Review recent changes
/catchup HEAD~3  # πŸ• Review specific commit

/research πŸ”¬

Parallel research with synthesized output:

/research "topic"            # πŸ“Š Standard research
/research "topic" --quick    # ⚑ Quick overview
/research "topic" --thorough # πŸ” Deep dive

πŸ“– Recipes

Reusable patterns for better development β€” now a proper skill with router and categorized references.

Category Recipes
πŸ€– AI Agent Patterns Agentic CLI, Extract Deterministic, Semantic Zoom
πŸ› οΈ Development Practices Comments, Writing Skills, Claude Tools, Snapshot Testing
πŸ“¦ Distribution Claude Plugin Authoring
πŸ—οΈ Architecture Python Project Architecture, Keyring Credential Storage

πŸ“š Full Documentation β†’


πŸ€– Agents

πŸ—ΊοΈ Code Map Explorer

Navigate codebases following the hierarchical map structure:

πŸ“– README β†’ πŸ—οΈ ARCHITECTURE β†’ 🏘️ Domains β†’ πŸ“¦ Modules β†’ πŸ” Code

πŸ› οΈ Installation

As a Claude Code Plugin

claude plugin marketplace add durandom/skills
claude plugin install ds

From Source (for development)

Prerequisites:

  • 🐍 Python 3.11+
  • πŸ“¦ UV package manager
# πŸ“₯ Clone the repository
git clone https://github.com/durandom/skills.git
cd skills

# πŸ“¦ Install dependencies
uv sync

# βœ… Run tests
uv run pytest

πŸ“ Project Structure

skills/
β”œβ”€β”€ πŸ“‚ skills/                 # 🧠 Core skills (bucketed for skills.sh discovery)
β”‚   β”œβ”€β”€ code/                  # πŸ—ΊοΈ Code comprehension
β”‚   β”‚   └── code-mapping/      # Hierarchical code navigation
β”‚   β”œβ”€β”€ dev-tools/             # πŸ› οΈ Developer workflow tools
β”‚   β”‚   β”œβ”€β”€ github/            # GitHub CLI operations
β”‚   β”‚   β”œβ”€β”€ recipes/           # Development patterns and guides
β”‚   β”‚   └── cass/              # Claude Code session search
β”‚   β”œβ”€β”€ integrations/          # πŸ”Œ Third-party SaaS integrations
β”‚   β”‚   └── jira/              # Jira issue management
β”‚   β”œβ”€β”€ knowledge/             # πŸ“š Personal knowledge & task mgmt
β”‚   β”‚   β”œβ”€β”€ gtd/               # GTD task management
β”‚   β”‚   β”œβ”€β”€ para/              # PARA organization
β”‚   β”‚   └── meeting-notes/     # Meeting transcript sync
β”‚   β”œβ”€β”€ meta/                  # 🧰 Authoring skills/agents
β”‚   β”‚   └── skill-architect/   # Design & audit skills
β”‚   └── web/                   # πŸ•·οΈ Web extraction
β”‚       └── crawl4ai/          # Web crawling
β”œβ”€β”€ πŸ“‚ commands/         # ⚑ Slash commands
β”œβ”€β”€ πŸ“‚ agents/           # πŸ€– Subagents
β”œβ”€β”€ πŸ“‚ fixtures/         # πŸ§ͺ Test fixtures
└── πŸ“‚ tests/            # βœ… Project tests

πŸ§ͺ Development

# 🧹 Run linting
uv run ruff check .

# πŸ”§ Auto-fix issues
uv run ruff check --fix .

# βœ… Run tests with snapshots
uv run pytest

# πŸ“Έ Update snapshots
uv run pytest --snapshot-update

🎯 Philosophy

This project follows key principles:

Principle Description
πŸ›‘οΈ Safe by Default AI agents can't skip safety steps
πŸ“š Documentation First Good docs enable good retrieval
🎯 Simple > Clever Prefer maintainable over impressive
πŸ”„ Agentic Workflows Designed for AI collaboration

πŸ“„ License

MIT Β© durandom


🌟 Happy coding! 🌟

Built with ❀️ for Claude Code

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors