neural-add-bug

neural-add-bug is a skill for Claude Code from Yakoub-ai/neural-memory. It costs 36 tokens per session (513 once invoked), scanned A, original, MIT.

A manual bug logger for Neural Memory, a knowledge graph that stores connected project information for later search. It records what went wrong and can link the bug to a source file and line.

In plain words
What is it for?
Use it to record a bug’s description, severity, location, root cause, and fix.
Why use it?
It keeps discovered bugs in the project’s searchable memory without waiting for another log-import process. This makes the cause and fix easier to find later.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions Claude Code.

Part of the neural-memory plugin — 13 skills, 6 commands, 3 agents, 2 hooks, 1 MCP server shipped together

Good fit Use it to record a bug’s description, severity, location, root cause, and fix.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/yakoub-ai/neural-memory/neural-add-bug
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 Yakoub-ai/neural-memory --skill neural-add-bug
Clone the repo
git clone --depth 1 https://github.com/Yakoub-ai/neural-memory

Made for: Claude Code.

Or install neural-memory, the plugin that ships this one along with the rest of its 13 skills, 6 commands, 3 agents, 2 hooks, 1 MCP server.

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 neural-add-bug

README.md
[![agentmods](https://agentmods.dev/badge/skills/yakoub-ai/neural-memory/neural-add-bug/github.svg)](https://agentmods.dev/skills/yakoub-ai/neural-memory/neural-add-bug)
Your own site
<a href="https://agentmods.dev/skills/yakoub-ai/neural-memory/neural-add-bug"><img src="https://agentmods.dev/badge/skills/yakoub-ai/neural-memory/neural-add-bug/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 neural-add-bug

Your own site · 80×15
<a href="https://agentmods.dev/skills/yakoub-ai/neural-memory/neural-add-bug"><img src="https://agentmods.dev/badge/skills/yakoub-ai/neural-memory/neural-add-bug.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 36 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 513 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.
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.00036 $0.00513
Opus 5 $0.00018 $0.00257
Sonnet 5 $0.00007 $0.00103
Haiku 4.5 $0.00004 $0.00051

Measured 11d ago against content hash 4c8bc2659346, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

neural-add-bug 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 11d 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.

skills/neural-add-bug/SKILL.md · 57 lines

What it actually says

Neural Memory — Add Bug

Manually create a bug node in the knowledge graph. Use this when you discover a bug during a session and want it indexed immediately, without waiting for a context log re-import.

How to call

Via MCP tool (neural-memory configured as MCP server in Claude Code):

Tool: neural_add_bug
{
  "description": "What went wrong",
  "severity": "high",
  "file_path": "neural_memory/parser.py",
  "line_start": 142,
  "root_cause": "Off-by-one in slice index",
  "fix_description": "Changed range(n) to range(n+1)"
}

Via Python (working directly in the project):

import asyncio
from neural_memory.server import neural_add_bug, AddBugInput

asyncio.run(neural_add_bug(AddBugInput(
    description="What went wrong",
    severity="high",
    file_path="neural_memory/parser.py",
    line_start=142,
    root_cause="Off-by-one in slice index",
    fix_description="Changed range(n) to range(n+1)",
)))

Parameters

Parameter Required Type Description
description Yes str What went wrong (min 3 chars)
severity No str "low" / "medium" / "high" / "critical" (default: "medium")
file_path No str Source file this bug relates to
line_start No int Starting line number
line_end No int Ending line number
root_cause No str Root cause description
fix_description No str How it was or should be fixed
project_root No str Project root (default: ".")

Notes

  • The bug node is linked to matching code nodes via RELATES_TO edges
  • It will appear in /neural-query results alongside code nodes
  • Bugs are also auto-imported from .claude/context-log-gotchas.md on every /neural-index
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. 11d ago First seen · 57 lines · 36 tokens per session scan A 4c8bc2659346

Subscribe to this mod's changes

neural-add-bug is a skill published in the GitHub repository Yakoub-ai/neural-memory (1 stars, last pushed 5mo ago), licensed MIT. It adds 36 tokens to every session and 513 once invoked, about $0.0002 per session on Opus 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-31.

Related

Other skills, from other repositories

compound-docs

Searchable Elixir/Phoenix/Ecto solution documentation system with YAML frontmatter. Builds institutional knowledge from solved problems. Use when consulting past solutions before investigating new issues.

oliver-kriska/claude-elixir-phoenix · 38 tokens

error-recovery

Maintains a project-specific known-issues.md mapping recurring errors to their solutions. Consulted automatically by systematic-debugging before investigation. Saves time by avoiding rediscovery of known problems across sessions. Triggers on: "save this fix", "remember this error", "known issues", or automatically…

brunob54/superpowers-orchestrator · 71 tokens

esp32-expert

This skill should be used for ESP32-specific hardware and runtime work in ESP-IDF, Arduino-ESP32, or PlatformIO projects: target/build detection, FreeRTOS tasks and ISRs, memory/DMA, peripherals, power, networking/security, OTA, crash diagnosis, and unattended reliability. Trigger on "debug this ESP32 crash", "review…

johnkozaris/jko-claude-plugins · 137 tokens

Closure Scope Retention Guard

Detects long-lived objects (caches, listeners, singletons) that capture an entire enclosing scope via closures/environment capture, keeping large arrays or buffers alive, and proposes copying only the needed fields.

s977043/river-review · 46 tokens

capturing-learnings

Records a real failure-and-fix pair as a project-local lesson, with the specifics that make it recognisable next time. Use when a bug, leakage mistake, or validation error was found and corrected and should not recur. Use when someone asks to save what was learned from an experiment that went wrong.

StamKavid/last-ds-mile · 66 tokens

vibe-debugging-journal

Records resolved bugs in a persistent journal — symptom, root cause, difficulty, fix, prevention. Organized by category for future reference.

ash1794/vibe-engineering · 33 tokens