writing-cli-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

ai-writing-tropes

Detect and eliminate common AI writing tropes from prose. Comprehensive catalog of patterns (word choice, sentence structure, paragraph layout, tone, formatting, composition) that mark AI-generated writing, with a self-check workflow. Source: tropes.fyi.

coding-standards

Language-agnostic coding standards for design-level code review and implementation judgment. Covers domain modeling, state, modules, boundaries, effects, error handling, verification, complexity, and maintainability.

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.

grug-brained-dev

Cognitive interrupt skill for code that looks clean but feels painful to change: too fancy, too abstract, too many files, too many helpers, too many layers, or too well-factored into the wrong boxes. Grug fights complexity demon by forcing big brain AI into smol brain posture: what thing, thing do what, where meat, why five caves?