joshthomas-agent-skills

agent-skills

A collection of skills for agentic LLM tools, following the Agent Skills specification.

Installation

• Agent-specific
  • Claude Code
  • OpenCode
• Package managers
  • dotagents
  • OpenSkills
  • skills.sh

Agent-specific

Claude Code

Install from the plugin marketplace:

/plugin marketplace add joshuadavidthomas/agent-skills

Install an individual skill plugin (recommended). Plugin names match skill directory names (for example sveltekit, skill-authoring, writing-cli-skills):

/plugin install reducing-entropy@joshthomas-agent-skills

Or install the bundle with all skills:

/plugin install all@joshthomas-agent-skills

CLI equivalent:

claude plugin install reducing-entropy@joshthomas-agent-skills --scope project

Requires Claude Code v1.0.33 or later.

OpenCode

Clone this repo and symlink the skills you want:

git clone https://github.com/joshuadavidthomas/agent-skills.git
cd agent-skills
mkdir -p ~/.config/opencode/skills
ln -s "$PWD/reducing-entropy" ~/.config/opencode/skills/reducing-entropy

OpenCode also discovers skills from .opencode/skills, .claude/skills, and .agents/skills in your project.

Requires OpenCode v1.0.190 or later, which has native skill loading built in. opencode-agent-skills is still available if you are stuck on an older version or if you want its specific loading behavior.

Package managers

dotagents

Install with dotagents:

npx @sentry/dotagents add joshuadavidthomas/agent-skills

Or install an individual skill:

npx @sentry/dotagents add joshuadavidthomas/agent-skills --name reducing-entropy

OpenSkills

Install with OpenSkills:

npx openskills install joshuadavidthomas/agent-skills
npx openskills sync

Use --global to install into ~/.claude/skills.

skills.sh

Install with skills.sh:

npx skills add joshuadavidthomas/agent-skills

Usage

Skills are model-invoked—the agent decides when to use them based on your request and the skill's description. You can also explicitly ask for a skill:

Use the reducing-entropy skill to review this refactor

or reference it by name when relevant to your task.

Skills

coolify-compose

Convert Docker Compose files to Coolify templates for both raw-compose and repository deployment modes. Covers Coolify magic variables (SERVICE_URL_*, SERVICE_PASSWORD_*), health checks, and common conversion/troubleshooting patterns.

crafting-effective-readmes

Guides you through writing READMEs matched to your audience and project type. Different audiences need different information—a contributor to an OSS project needs different context than future-you opening a config folder.

Uses a structured process to identify task type (creating, adding, updating, or reviewing) and ask relevant questions before drafting.

Includes:

• Templates for open source, personal, internal, and config projects
• Section checklist showing which sections matter for each project type
• Style guide covering common mistakes
• Reference materials: Standard README spec (with examples), "Art of README", and Make a README guide

diataxis

Apply the Diátaxis framework for documentation structure and writing. Helps classify and produce tutorials, how-to guides, reference, and explanation docs.

frontend-design-principles

Design-focused frontend skill for producing intentional, non-generic interfaces. Includes required discovery gates, signature-definition workflow, and self-review checks before presenting UI output.

jj

Jujutsu (jj) version control for Git-compatible repos. Covers the mental model (working copy as commit, change IDs, mutable history), agent-specific rules (always -m, no interactive commands), daily workflows, and progressive deep dives into revsets/filesets/templates, bookmarks and sharing, history rewriting, workspaces for parallel agents, and configuration.

Includes 13 reference files covering Git-to-jj command mapping, revset/fileset/template language specs, bookmark management, GitHub workflows, conflict handling, and more.

improving-prompts

Apply Anthropic's documented Claude 4.5 best practices to CLAUDE.md, AGENTS.md, custom commands, and skill files. Uses actual guidance from Anthropic instead of inventing improvements.