Agent skill

Plugin Dev Workflow

by oliver-kriska in oliver-kriska/claude-elixir-phoenix

Guide plugin development workflow — editing skills, agents, hooks, or eval framework in this repo.

MITAuto-check passedAgent Workflows

Install Plugin Dev Workflow

skills CLI
$ npx skills add oliver-kriska/claude-elixir-phoenix --skill plugin-dev-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oliver-kriska/claude-elixir-phoenix plugin-dev-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oliver-kriska/claude-elixir-phoenix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/plugin-dev-workflow .claude/skills/plugin-dev-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
plugin-dev-workflow
GitHub stars
564
Token cost
~1k tokens
SKILL.md length
369 words
Files
1
Skills in repo
107
Repo updated
First seen
Licence
MIT

At a glance

Guide plugin development workflow — editing skills, agents, hooks, or eval framework in this repo.

  • Works in 6 steps: Read CLAUDE.md conventions (size limits,… → Make your changes → Run make eval — it auto-detects changed… → …
  • Modifying files in plugins/elixir-phoenix/
  • SKILL.md covers Before You Start, Scoring Individual Files (CLI), When Editing Skills… and When Editing Agents…, plus 5 more sections
  • Calls make, python3 and claude

What it does

Plugin Dev Workflow is an agent skill from oliver-kriska/claude-elixir-phoenix. Guide plugin development workflow — editing skills, agents, hooks, or eval framework in this repo. Use when modifying files in plugins/elixir-phoenix/, lab/eval/, or lab/autoresearch/. Ensures changes pass eval, lint, and tests before committing.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering LLM observability, Hooks and plugins and Autonomous loops. It works with Elixir. The repository describes itself as: Claude Code plugin for Elixir/Phoenix/LiveView — 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration. Plan features with parallel research agents, execute… The licence is MIT.

When your agent uses it

  • Modifying files in plugins/elixir-phoenix/
  • Lab/autoresearch/

Example prompts

  • “/plugin-dev-workflow”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Read CLAUDE.md conventions (size limits, frontmatter requirements)
  2. Make your changes
  3. Run make eval — it auto-detects changed skills and scores them
  4. If FAIL: check the dimension that failed, fix it
  5. Run make lint to verify markdown formatting
  6. Commit

What it can do on your machine

Read from SKILL.md and the folder at commit 9767a82. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • make
    • python3
    • claude

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Plugin Dev Workflow loads about 1k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 369 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oliver-kriska/claude-elixir-phoenix at commit 9767a82, republished under its MIT licence (© oliver-kriska). 369 words, ~1,049 tokens.

Download SKILL.mdSave it as .claude/skills/plugin-dev-workflow/SKILL.md (or your agent's skills folder).
name
plugin-dev-workflow
description
Guide plugin development workflow — editing skills, agents, hooks, or eval framework in this repo. Use when modifying files in plugins/elixir-phoenix/, lab/eval/, or lab/autoresearch/. Ensures changes pass eval, lint, and tests before committing.
effort
medium

Plugin Development Workflow

This repo is the Elixir/Phoenix Claude Code plugin. When editing plugin files, follow this workflow to ensure quality.

Before You Start

Run make help to see all available commands:

bash
make eval          # Quick: lint + score changed skills/agents
make eval-all      # Full: all 51 skills + 26 agents
make eval-fix      # Auto-fix + show failures
make test          # 220 pytest tests for eval framework and port tooling
make ci            # Full CI pipeline

Scoring Individual Files (CLI)

IMPORTANT: Always use -m module syntax, never run scorer.py directly.

bash
# Score ONE skill (use -m, NOT direct file path)
python3 -m lab.eval.scorer plugins/elixir-phoenix/skills/verify/SKILL.md

# Score ONE skill with pretty output
python3 -m lab.eval.scorer plugins/elixir-phoenix/skills/verify/SKILL.md --pretty

# Score all skills
python3 -m lab.eval.scorer --all

# Score ONE agent
python3 -m lab.eval.agent_scorer plugins/elixir-phoenix/agents/verification-runner.md

# Score all agents
python3 -m lab.eval.agent_scorer --all
make ci            # Full CI pipeline

When Editing Skills (plugins/elixir-phoenix/skills/*/SKILL.md)

  1. Read CLAUDE.md conventions (size limits, frontmatter requirements)
  2. Make your changes
  3. Run make eval — it auto-detects changed skills and scores them
  4. If FAIL: check the dimension that failed, fix it
  5. Run make lint to verify markdown formatting
  6. Commit

Skill requirements (eval checks all of these):

  • Frontmatter: name, description, effort. Description must start with action verb + include "Use when..."
  • Iron Laws section with 1+ numbered items
  • Under 185 lines (command skills) or 150 lines (reference skills)
  • No section exceeds 45 lines
  • All /phx: references point to existing skills
  • All references/*.md paths exist
  • No dangerous code patterns outside Iron Laws sections
  • Code examples present (1+ fenced code blocks)
  • "Use when..." in description (for trigger accuracy)

When Editing Agents (plugins/elixir-phoenix/agents/*.md)

  1. Make your changes
  2. Run make eval-agents to score all agents
  3. Agent requirements:
    • no permissionMode (plugin agents ignore it; the plugin directory fails bypassPermissions)
    • disallowedTools: Write, Edit, NotebookEdit for review/analysis agents
    • model matches effort: haiku=low, sonnet=medium, opus=high
    • Under 300 lines (specialist) or 535 lines (orchestrator)
Show full SKILL.md (150 more words)Show less

When Editing Eval Framework (lab/eval/*.py)

  1. Make your changes
  2. Run make test — all pytest tests must pass
  3. Run make eval-all — verify no skills/agents regressed
  4. If adding new matchers: add tests in lab/eval/tests/test_matchers.py

When Editing Hooks (plugins/elixir-phoenix/hooks/scripts/*.sh)

  1. Make your changes
  2. Run make lint (markdown in hook comments)
  3. Test the hook manually (hooks run on Edit/Write/Bash events)
  4. Check CLAUDE.md hook documentation is still accurate

Autoresearch (Self-Improvement Loop)

If make eval-fix shows failures, it suggests an autoresearch command:

bash
# Copy-paste the suggested command from eval-fix output
claude -p 'Run autoresearch. Score all skills...' --allowedTools 'Edit,Read,Write,Bash,Glob,Grep'

This runs the autoresearch loop: find weakest skill → fix ONE issue → re-score → keep/revert.

Pre-Commit Checklist

Before committing any plugin changes:

  • make lint passes
  • make eval passes (changed files)
  • make test passes (if eval framework changed)
  • CHANGELOG.md updated (if user-visible change)
  • Version bumped in plugin.json (if releasing)

References

  • CLAUDE.md — full conventions, size limits, checklist
  • lab/eval/ — scoring framework (24 matchers, 8 dimensions)
  • lab/autoresearch/ — self-improvement loop
  • lab/findings/interesting.jsonl — log interesting discoveries here

© oliver-kriska, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/plugin-dev-workflow of oliver-kriska/claude-elixir-phoenix.

Open the folder on GitHubat commit 9767a82

Compare with similar skills

Plugin Dev Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Plugin Dev Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plugin Dev Workflow this skilloliver-kriska/claude-elixir-phoenix564—~1kAutomated safety check: PassMIT
Plugin CreatoruseLexora/Lexora522—~1kAutomated safety check: PassAGPL-3.0
Harness Engineering10xChengTu/harness-engineering1021 repos~1kAutomated safety check: PassNone
Nonstop Autonomous Modeandylizf/nonstop263—~2kAutomated safety check: WarnMIT
Superloopy Doctorbeefiker/superloopy1111 repos~1.9kAutomated safety check: PassMIT
Creating Pluginsjaktestowac/awesome-copilot-for-testers116—~3.3kAutomated safety check: PassMIT

Similar skills

  • Plugin Creator

    useLexora/Lexora

    创建、修改并验证可安装的 Lexora 桌面插件,包括工作台装饰、导航与面板、文件阅读工具、控件样式、网络查询、通知和定时命令。也响应 $plugin-creator。普通任务执行、使用现有插件、其他产品的插件开发不属于此技能。

    522 GitHub stars~1k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Harness Engineering

    10xChengTu/harness-engineering

    Set up and improve harness engineering (AGENTS.md, docs/, lint rules, eval systems, project-level prompt engineering) for AI-agent-friendly codebases.

    102 GitHub starsUsed in 1 repo~1k tokens
    Agent WorkflowsAuto-check passed
  • Nonstop Autonomous Mode

    andylizf/nonstop

    Lets Claude keep working while you are away, after a pre-flight that surfaces blockers, risky operations and open decisions, with a stop hook scoped to the session.

    263 GitHub stars~2k tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check: warnings
  • Superloopy Doctor

    beefiker/superloopy

    A read-only health check for a Superloopy install or checkout: state folders, evidence files, bundled agents, hooks, wrapper and plugin registration, reported before any repair.

    111 GitHub starsUsed in 1 repo~1.9k tokens
    Agent WorkflowsAuto-check passed
  • Creating Plugins

    jaktestowac/awesome-copilot-for-testers

    Packages repository skills as installable Copilot plugins: marketplace registration, plugin.json manifests, generated skill copies, and the sync check CI enforces.

    116 GitHub stars~3.3k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Adversarial Elixir

    pproenca/dot-skills

    A skill your agent uses to gate Elixir, OTP, Ecto, and Phoenix code with a pass/fail adversarial review — a single blind reviewer subagent judges a diff or file set against 19 decidable rules that…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from oliver-kriska/claude-elixir-phoenix

All 107 skills in this repo
  • Phx Brief

    oliver-kriska/claude-elixir-phoenix

    Interactive briefing of a plan file — explains reasoning, schema decisions, component choices.

    564 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Codex Ab

    oliver-kriska/claude-elixir-phoenix

    Run an A/B codex review experiment — holistic codex review vs 3 focused dimension passes (security, ecto, liveview) on the branch diff, classify findings, report a panel-value verdict.

    564 GitHub stars~977 tokensUpdated 2 days ago
    Auto-check passed
  • Audit

    oliver-kriska/claude-elixir-phoenix

    Project health audit and health check — architecture, performance, tests, dependencies, code quality.

    564 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Compound Docs

    oliver-kriska/claude-elixir-phoenix

    Searchable Elixir/Phoenix/Ecto solution documentation system with; Use when consulting past solutions…

    564 GitHub stars~528 tokensUpdated 2 days ago
    Auto-check passed
  • Compound Docs

    oliver-kriska/claude-elixir-phoenix

    Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter.

    564 GitHub stars~547 tokensUpdated 2 days ago
    Auto-check passed
  • Deploy

    oliver-kriska/claude-elixir-phoenix

    Elixir/Phoenix deployment patterns — Dockerfile, fly.toml, runtime.exs, mix release, rel/ overlays.

    564 GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Plugin Dev Workflow

What does Plugin Dev Workflow do?

Guide plugin development workflow — editing skills, agents, hooks, or eval framework in this repo. Plugin Dev Workflow is an agent skill from oliver-kriska/claude-elixir-phoenix. Guide plugin development workflow — editing skills, agents, hooks, or eval framework in this repo.

When should I use Plugin Dev Workflow?

Plugin Dev Workflow fits situations like: modifying files in plugins/elixir-phoenix/; lab/autoresearch/.

How do I install Plugin Dev Workflow in Claude Code?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill plugin-dev-workflow -a claude-code`. Or copy the skill folder (.claude/skills/plugin-dev-workflow in oliver-kriska/claude-elixir-phoenix) into .claude/skills/plugin-dev-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Plugin Dev Workflow in Codex?

Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill plugin-dev-workflow -a codex`. Or copy the skill folder (.claude/skills/plugin-dev-workflow in oliver-kriska/claude-elixir-phoenix) into .agents/skills/plugin-dev-workflow in your project. Codex loads it when a task matches its description.

Can I use Plugin Dev Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oliver-kriska/claude-elixir-phoenix --skill plugin-dev-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plugin-dev-workflow, .gemini/skills/plugin-dev-workflow, .github/skills/plugin-dev-workflow and .opencode/skills/plugin-dev-workflow in your project.

What does Plugin Dev Workflow need to run?

Going by SKILL.md and its folder, Plugin Dev Workflow needs the command-line tools its instructions call (make, python3 and claude). Our summary lists: Python 3.

Does Plugin Dev Workflow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Plugin Dev Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Plugin Dev Workflow use?

Plugin Dev Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plugin Dev Workflow use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Plugin Dev Workflow?

Skills that share tags, products or a category with Plugin Dev Workflow: Plugin Creator (useLexora/Lexora, 522 stars), Harness Engineering (10xChengTu/harness-engineering, 102 stars), Nonstop Autonomous Mode (andylizf/nonstop, 263 stars) and Superloopy Doctor (beefiker/superloopy, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plugin Dev Workflow?

oliver-kriska (a GitHub user) maintains it in oliver-kriska/claude-elixir-phoenix, which has 564 GitHub stars. The repository holds 107 skills in this directory. The repository was last updated on October 5, 2026.

Source: oliver-kriska/claude-elixir-phoenix on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.