dev-guides-navigator

Claude Skills

Custom plugins and tools for Claude Code.

Heads up (transition notice, kept through ~August 2026). drupal-dev-framework has been renamed to ai-dev-assistant (same workflow, broader scope, command names unchanged). If you already have the old plugin installed: install ai-dev-assistant, run /drupal-dev-framework:upgrade once to migrate your project store and per-project wiring, then uninstall drupal-dev-framework (/plugin uninstall drupal-dev-framework@camoa-skills). The shell exposes only /drupal-dev-framework:upgrade; everything else now lives under the ai-dev-assistant: namespace. A few other plugins got minor description and tone cleanups in the same pass. Full steps: drupal-dev-framework/README.md.

Background

I started building what I called "frameworks" over a year before Claude officially released Skills. Same concept, different name.

The idea came from frustration. I was tired of repeating the same instructions every conversation. Instead of starting fresh each time, I asked AI to analyze our successful interactions and create frameworks capturing recurring requirements and preferences. These became reusable project knowledge.

This approach produced results: 3 published Drupal contrib modules, 17+ blog articles, automated social media campaigns, and phase-based editorial workflows.

When Claude released Skills officially, I recognized what I'd been building. This repository translates those frameworks into proper Skills with tooling.

I wrote more about this methodology in My Journey with AI Tools.

Installation

# Add the marketplace
/plugin marketplace add https://github.com/camoa/claude-skills

# Install individual plugins
/plugin install dev-guides-navigator@camoa-skills
/plugin install ai-dev-assistant@camoa-skills
/plugin install plugin-creation-tools@camoa-skills
/plugin install brand-content-design@camoa-skills
/plugin install code-quality-tools@camoa-skills
/plugin install drupal-htmx@camoa-skills
/plugin install code-paper-test@camoa-skills
/plugin install drupal-ai-contrib@camoa-skills

Using these plugins outside Claude Code

Skills in this marketplace conform to the open agentskills.io standard and work in Cursor, Codex CLI, VS Code Copilot, Gemini CLI, Cline, OpenCode, and more. Commands, agents, and hooks are Claude-Code-specific by format but can be emulated. See PORTABILITY.md for the full guide and CURSOR.md for Cursor-specific notes.

Known Issues

Skills not auto-discovered on startup

There's a known bug in Claude Code affecting git-based marketplaces. Skills may fail to load during initialization with "no such file or directory" errors because Claude Code looks for skill files in the wrong location.

Workaround: Skills still work when invoked via the Skill tool (slash commands). The issue only affects automatic discovery at startup.

Status: Awaiting fix from Anthropic.

Plugins

dev-guides-navigator (v0.1.0)

Smart guide discovery and routing for the dev-guides site. Routes AI to the correct guide using hash-based caching and KG metadata for disambiguation.

• Caches llms.txt with hash-based freshness check: no redundant fetches
• KG metadata (concepts/not fields) prevents wrong-guide selection (e.g., "story.yml" routes to UI Patterns, not Storybook)
• Two-hop routing: llms.txt → topic index.md → specific guide
• 1200+ atomic decision guides across 66 topics

# Invoked automatically before design/dev tasks, or manually:
/dev-guides-navigator style guide

ai-dev-assistant (v5.0.0)

An AI assistant for developers that focuses on getting the process right, not just getting code out fast. Most AI dev tools optimize for speed. This one keeps the work disciplined: understand the problem before coding, reuse what already exists, follow your standards, and verify. It runs each task through Research → Architecture → Implementation → Review, with deterministic gates (SOLID, TDD, DRY, security, code purposefulness) the AI can't quietly skip, and grounds its decisions in best-practice guides instead of whatever the model guessed. Requires dev-guides-navigator. Stack-agnostic engine; ships with a Drupal-flavored reference implementation for the deep components (a stack-neutral generalization is in progress).