claude

cc-authoring

Hard-won gotchas from authoring and distributing Claude Code plugins, skills, hooks, and Workflow scripts. Bundles APM packaging traps, plugin cache and marketplace path failures, hook main-vs-subagent detection, Workflow meta parsing breaks, and orchestration verification playbooks.

0 on GitHubby Raul Cajiasv0.1.1MITupdated 1 month ago
/

Plugin cc-authoring from marketplace claude-skills in cajias/claude-skills. Commands read from the repo's manifest — 1 month ago.

What it installs

Skills (16)

  • apm-marketplace-authoring-gotchas

    Eight APM-marketplace-authoring gotchas discovered during real migrations from hand-authored .claude-plugin/marketplace.json to APM-managed and from CC-native plugin authoring. Use when: (1) running APM's packaging step (with or without `--dry-run`) or its marketplace-check command in a repo with an

  • apm-plugin-distribution-paths

    Canonical authoring layout for an APM (microsoft/apm) package, plus the decision matrix for whether you need a `marketplace:` block. Use when: (1) you've run `apm init` and are unsure where SKILL.md / agent .md / command .md files belong (answer: under `.apm/`, NOT at repo root); (2) you've authored

  • autoresearch-is-code-metric-optimizer

    The `/autoresearch:autoresearch` Claude Code skill is a CODE-METRIC OPTIMIZER (modify → verify → keep/discard loop). Use when: (1) you are about to invoke `/autoresearch:autoresearch` to do literature / web research (it does NOT fetch papers, search the web, or synthesize cited reports — use `/deep-

  • cc-hooks-main-vs-subagent

    How a Claude Code PreToolUse/PostToolUse hook can tell whether a tool call came from the MAIN conversation thread or from a SUBAGENT (Task/Agent tool), plus the gotchas of testing hooks via headless `claude -p`. Use when: (1) building a hook that should apply only to the main thread (e.g. orchestrat

  • cc-mid-session-registry-staleness

    Fix for two Claude Code mid-session staleness traps that fail Workflow runs instantly (<15ms). Use when: (1) a Workflow agent() call fails with "agent type '<name>' not found" listing only plugin/built-in agents, even though .claude/agents/<name>.md exists with valid frontmatter — the agent registry

  • cc-plugin-cache-multi-version-not-recorded

    Fix for Claude Code startup warning `Plugin "<name>" not cached at (not recorded) — run /plugins to refresh`. Use when: (1) Claude Code prints a `plugin-cache-miss` warning whose installPath is the literal string `(not recorded)`; (2) `claude plugin list` shows the plugin as installed with a valid v

  • cc-pluginroot-directory-source-ignored

    Fix for the Claude Code startup error `Plugin directory not found at path: <marketplace_root>/<plugin_name>. Check that the marketplace entry has the correct path.` when a local `source: "directory"` marketplace uses `metadata.pluginRoot` to factor a common prefix out of its plugin sources. Use when

  • claude-print-subprocess-error-streams

    Fix for opaque `RuntimeError: Claude session failed: ` (or any wrapper-error with empty content) when wrapping `claude --print --output-format json` in Python subprocess. Use when: (1) you wrap `claude --print` (or any `claude` non-interactive CLI invocation) via `subprocess.run` / `subprocess.commu

  • claude-workflow-authoring-gotchas

    Four gotchas that bite when authoring Claude Code Workflow scripts (the `Workflow` tool's `.js` files with `export const meta`). Use when: (1) Workflow tool call fails immediately with `Invalid workflow script: meta must be a pure literal: non-literal node type in meta: BinaryExpression`; (2) the sc

  • claude-workflow-meta-markdownlint-pure-literal-break

    Fix for a Claude Code Workflow script that fails to load with "meta must be a pure literal: non-literal node type in meta: BinaryExpression" even though the meta block looks fine and all its tests pass. Use when: (1) a workflow .js is rejected at load over meta/BinaryExpression; (2) workflow tests a

  • claude-workflow-plugin-distribution

    How to distribute a Claude Code Workflow-tool script (the Workflow({script}) orchestration engine / .claude/workflows/*.js) through a plugin or marketplace, and how to architect it around the Workflow sandbox. Use when: (1) you want to "ship / package / distribute a workflow" in a plugin; (2) design

  • find-skills

    Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable ski

  • plan-mode-orchestrator-write-deadlock

    Recognize and escape the deadlock where NO write can succeed because plan mode and an "orchestrator mode" hook block each other. Use when: (1) a PostToolUse/ PreToolUse hook returns "ORCHESTRATOR MODE: the main thread must not edit or write files directly... delegate it to a subagent"; (2) you are A

  • skill-creator-trigger-eval-gotchas

    Six chained gotchas when running the skill-creator plugin's trigger-eval machinery (scripts/run_loop.py, scripts/run_eval.py) against a skill. Use when: the trigger eval reports 0% recall or "skill never triggers" even on verbatim trigger phrases; `python -m scripts.run_loop` fails with `ModuleNotFo

  • team-mode-orchestration-verification

    Verify teammate work in Claude Code team mode when main-thread TaskList appears empty or teammates go idle without sending SendMessage replies. Use when: (1) you've created a team via TeamCreate and TaskCreate but `TaskList` returns "No tasks found" from the main thread, (2) a teammate sends only id

  • vhs-claude-plugin-demos

    Make a hero GIF demo of a Claude Code plugin using VHS (charmbracelet/vhs). Use when: (1) writing a plugin README and want a terminal-demo GIF, (2) recording a screencast of a CLI that is ALSO wrapped by Claude Code slash commands, (3) the plugin has both slash commands (e.g. `/kb-query`) and an und

View source on GitHub

More from cajias/claude-skills

All 19 plugins →

rsi-loop

claude

AIDE²-style recursive self-improvement loop: an outer agent iteratively rewrites an inner tree-search research agent, keeping a rewrite only when it beats the incumbent on private held-out scores under a fixed budget across an optimization / ML-engineering / harness-engineering battery. Standalone /rsi:autoresearch solves tasks by tree search; /rsi:init + /rsi:step + /rsi:run drive the outer loop.

2 skills · 6 commands · 2 agents · hooks

0

Design-and-build process skills: layered design docs, C4 architecture artifacts, Diataxis documentation, README authoring, a milestone execution harness, milestone goal-prompt generation, positive-framing spec guidance, and a schema drift playbook.

8 skills

0

Operational gotchas and references for third-party integrations driven from Claude Code — Cloudflare Workers, Grafana, Notion, OpenPencil, Playwright, and MCP file transport.

7 skills

0

Hard-won gotchas from real git and gh workflows: PR create/merge quirks, worktree races, rebase in non-interactive shells, squash-merge diagnosis, and deadlock recovery via plumbing.

6 skills

0

ci-build

claude

Hard-won gotchas from CI pipelines and build environments: GitHub Actions, Copilot CLI headless runs, cron block generation, Docker on Apple Silicon, and TypeScript monorepo scaffolding.

5 skills

0

Hard-won gotchas from the Python toolchain: importlib class identity, pip/PyPI name collisions, mock.patch.object vs __slots__, ruff on notebooks, and uv in fresh worktrees.

5 skills

0

Similar plugins

superpowers

claudecodex

Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques

15 skills · hooks

obra/superpowers 316,836

claude-mem

claudecodex

Persistent memory for Claude Code: the next session starts where the last one left off.

29 skills · 1 MCP server · hooks

thedotmack/claude-mem 116,618

career-ops

claudecodex

Open-source AI job search that runs locally in your AI coding CLI: scan job portals, evaluate listings into a structured A-H report with a 1-5 score, tailor your CV, track applications

5 skills · hooks

career-ops-hq/career-ops 82,253

Backend API design, GraphQL architecture, workflow orchestration with Temporal, and test-driven backend development

9 skills · 1 command · 8 agents

wshobson/agents 42,461

beads

claudecodex

AI-supervised issue tracker for coding workflows

1 skill · 1 agent · hooks

gastownhall/beads 28,698

MiniMax AI skills library for frontend, fullstack, Android, iOS, shader, GIF sticker, document, presentation, spreadsheet, and multimodal media workflows

18 skills

MiniMax-AI/skills 13,828

Maintain cc-authoring?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins19 plugins