joycraft-bugfix

joycraft-bugfix is a skill for Claude Code, Codex from maksutovic/joycraft. It costs 29 tokens per session (3,084 once invoked), scanned A, original, MIT.

A step-by-step process for investigating and fixing software bugs.

In plain words
What is it for?
Use it to triage bug reports, trace errors through source code, discuss the diagnosis, and prepare an implementation specification.
Why use it?
It prevents changes based on guesses by first recording the symptoms, reproducing the problem, finding its cause, and agreeing on a focused fix.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents); $skill-name invocation.

Good fit Use it to triage bug reports, trace errors through source code, discuss the diagnosis, and prepare an implementation specification.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/maksutovic/joycraft/joycraft-bugfix
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add maksutovic/joycraft --skill joycraft-bugfix
Clone the repo
git clone --depth 1 https://github.com/maksutovic/joycraft

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for joycraft-bugfix

README.md
[![agentmods](https://agentmods.dev/badge/skills/maksutovic/joycraft/joycraft-bugfix/github.svg)](https://agentmods.dev/skills/maksutovic/joycraft/joycraft-bugfix)
Your own site
<a href="https://agentmods.dev/skills/maksutovic/joycraft/joycraft-bugfix"><img src="https://agentmods.dev/badge/skills/maksutovic/joycraft/joycraft-bugfix/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for joycraft-bugfix

Your own site · 80×15
<a href="https://agentmods.dev/skills/maksutovic/joycraft/joycraft-bugfix"><img src="https://agentmods.dev/badge/skills/maksutovic/joycraft/joycraft-bugfix.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,084 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00029 $0.03084
Opus 5.5 $0.00012 $0.01234
Sonnet 5.5 $0.00006 $0.00617
Haiku 4.5 $0.00003 $0.00308

Measured 29d ago against content hash ba99f7520355, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

joycraft-bugfix scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 29d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/joycraft-bugfix/SKILL.md · 257 lines

How it starts

The opening of the file, as written. The whole thing — 257 lines — stays where its author put it; the contents beside it link to each section on GitHub.

At skill entry, run node docs/.joycraft/check.mjs check --json --session <session-id> once, reusing JOYCRAFT_SESSION_ID if supplied or one ID chosen for this conversation. If the checker is missing or fails, continue the requested skill quietly without retrying setup. Offer updates only for display: true; current, postponed, off, and unknown stay quiet. If automaticUpdate is present, finish this skill, then run its exact command once from the project root: the candidate must verify every safety gate before applying. Other updates require approval. After an offer or automatic attempt, record it with node docs/.joycraft/check.mjs acknowledge <available-version> --session <session-id>. Apply updates only at this workflow boundary; after success, reinvoke the skill or restart the session to load changed instructions.

Bug Fix Workflow

You are fixing a bug. Follow this process in order. Do not skip steps.

Guard clause: If this is clearly a new feature, redirect to $joycraft-new-feature and stop.

Intent path argument: if the user passed an intent path (docs/intent/<name>.md, shaped by docs/templates/INTENT_TEMPLATE.md), read it and start Phase 1 triage from its Problem (the symptom) and Affected users and systems (where to look) instead of a blank symptom question; ask about anything missing through the question directive. If the intent path does not exist, say so in one line and triage from scratch. If its Status: already says it was consumed, tell the human by which skill and proceed only on their go-ahead. Normalize the path to project-relative for the spec's intent: key (Phase 4). After writing the spec, overwrite the intent's Status: line in place with Status: consumed by joycraft-bugfix → docs/bugfixes/<area>/<name>.md (YYYY-MM-DD). The intent file stays in docs/intent/ — never move, delete, or archive it. With no argument, run every phase exactly as below.


Phase 1: Triage

Establish what's broken. Gather: symptom, steps to reproduce, expected vs actual behavior, when it started, relevant logs/errors. If an error message or stack trace is provided, read the referenced files immediately. Try to reproduce if steps are given.

Read the full file on GitHub · 257 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 29d ago Changed · +6 lines ba99f7520355
  2. 1mo ago Changed · +2 lines 035ee49dd48a
  3. 1mo ago First seen · 249 lines · 29 tokens per session scan A 393fe6351ba3

Subscribe to this mod's changes

joycraft-bugfix is a skill published in the GitHub repository maksutovic/joycraft (15 stars, last pushed 28d ago), licensed MIT. It adds 29 tokens to every session and 3,084 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

email-content-guide

Best practices for email content that avoids spam filters. Apply these rules when writing email copy, building templates, or debugging spam placement issues.

wraps-team/wraps · 31 tokens

debugging-executions

Debug failed or wrong-output workflow executions using executions tools. Load when the user reports execution failures, unexpected node output, empty parameter values after a successful run, or a node showing a red or failed expression error. Also load when a live run you started for the user fails with an error from…

n8n-io/n8n · 86 tokens

output-debug-workflow

Debug Output SDK workflow issues. Use when user reports a workflow failing, erroring, hanging, producing wrong results, or asks to debug, troubleshoot, or investigate a workflow execution.

growthxai/output · 41 tokens

angular

Use when building, refactoring, or debugging Angular (v20/21+): standalone components, signals, zoneless change detection, @if/@for/@defer control flow, inject() DI, resource()/httpResource(), RxJS interop, NgRx SignalStore, ng CLI. NOT React (that is react), NOT Next.js (that is nextjs), NOT a TypeScript language…

ericrisco/rsc-harness · 89 tokens

debugging-table-access-denied

Debugs a TableAccessDeniedError from an error tracking issue, Slack alert, or user report. Use when investigating why HogQL denied a system or warehouse table and whether the occurrence is a real bug or expected behavior. Trigger terms include TableAccessDeniedError, tableaccessdenied, and "You don't have access to…

PostHog/posthog · 73 tokens

agent-upkeep

Perform one small, scoped maintenance improvement to the Elements monorepo and open a single reviewable pull request. Use this skill for scheduled or unattended upkeep runs that improve unit test coverage for one file, fix one behavioral bug in one module, or move one off ESLint rule toward enforcement to reduce…

NVIDIA/elements · 115 tokens