Skip to content

m3taz-ahmed/aizee / skills/bmad-toolsmith

bmad-toolsmith

Verified

Smithy the Toolsmith builds and maintains BMad skills, agents and modules. Use when the user asks for Smithy or says "build a skill", "make an agent", "scaffold a skill", "turn my session logs into a skill", "fix this skill", "convert this prompt to a skill", "review this skill", "optimize this skill", "cut this skill down", "make this skill BMad compliant", "package a module", "validate my module" or "migrate my old module". Not for running evals (`bmad-eval`) or overriding an installed skill (`bmad-customize`).

FileKindSize
SKILL.mdskill md3.6 KB
approaches/eval-first.mdmarkdown1.3 KB
approaches/eval-loop.mdmarkdown2.4 KB
approaches/from-logs.mdmarkdown1.7 KB
approaches/lean.mdmarkdown1.7 KB
approaches/scaffold.mdmarkdown1.3 KB
approaches/skill-creator-loop.mdmarkdown1.2 KB
bmod.tomlconfig118 B
canon.mdmarkdown10.5 KB
customize.tomlconfig4.8 KB
discover.mdmarkdown5.5 KB
evals/triggers.jsonconfig3.3 KB
lenses/lens-architecture.mdmarkdown2.9 KB
lenses/lens-contract.mdmarkdown1.4 KB
lenses/lens-customization.mdmarkdown2.4 KB
lenses/lens-determinism.mdmarkdown1.8 KB
lenses/lens-leanness.mdmarkdown3.1 KB
lenses/lens-trigger.mdmarkdown2.4 KB
lenses/standards.mdmarkdown5.2 KB
modes/convert.mdmarkdown2.1 KB
modes/cut-roles.mdmarkdown3.3 KB
modes/cut.mdmarkdown3.3 KB
modes/edit.mdmarkdown1.3 KB
modes/migrate.mdmarkdown3.3 KB
modes/package.mdmarkdown2.6 KB
modes/review.mdmarkdown1.3 KB
modes/validate.mdmarkdown1.8 KB
scripts/count_tokens.pyscript3.6 KB
scripts/cut_check.pyscript5.1 KB
scripts/init_skill.pyscript13.3 KB
scripts/prepass.pyscript7.5 KB
scripts/process_template.pyscript4.8 KB
scripts/read_session_log.pyscript9.8 KB
scripts/registry.pyscript5.9 KB
scripts/scan_legacy_module.pyscript7.7 KB
scripts/scan_paths.pyscript9.2 KB
scripts/scan_scripts.pyscript6.6 KB
scripts/tests/test_count_tokens.pyscript4.1 KB
scripts/tests/test_cut_check.pyscript3.1 KB
scripts/tests/test_init_skill.pyscript9.7 KB
scripts/tests/test_memory_agent_scripts.pyscript8.6 KB
scripts/tests/test_prepass.pyscript8.3 KB
scripts/tests/test_process_template.pyscript4.7 KB
scripts/tests/test_read_session_log.pyscript7.3 KB
scripts/tests/test_registry.pyscript6.0 KB
scripts/tests/test_scan_legacy_module.pyscript8.2 KB
scripts/tests/test_scan_paths.pyscript7.7 KB
scripts/tests/test_scan_scripts.pyscript4.1 KB
shapes/agent/assets/SKILL-template.mdmarkdown2.0 KB
shapes/agent/assets/capability-template.mdmarkdown582 B
shapes/agent/assets/customize-template.tomlconfig1.9 KB
shapes/agent/assets/sample-capability.mdmarkdown887 B
shapes/agent/shape.mdmarkdown3.2 KB
shapes/memory-agent/assets/BOND-template.mdmarkdown392 B
shapes/memory-agent/assets/CAPABILITIES-template.mdmarkdown1017 B
shapes/memory-agent/assets/CREED-template.mdmarkdown2.1 KB
shapes/memory-agent/assets/HOW-I-REMEMBER-template.mdmarkdown3.3 KB
shapes/memory-agent/assets/PERSONA-template.mdmarkdown705 B
shapes/memory-agent/assets/PULSE-template.mdmarkdown849 B
shapes/memory-agent/assets/SKILL-template-bootloader.mdmarkdown4.2 KB
shapes/memory-agent/assets/customize-template.tomlconfig1.2 KB
shapes/memory-agent/assets/first-breath-config-template.mdmarkdown4.5 KB
shapes/memory-agent/assets/first-breath-template.mdmarkdown9.3 KB
shapes/memory-agent/assets/init-sanctum-template.pyscript5.7 KB
shapes/memory-agent/assets/intake-capability-template.mdmarkdown975 B
shapes/memory-agent/assets/wake-template.pyscript6.8 KB
shapes/memory-agent/shape.mdmarkdown5.0 KB
shapes/multi-skill-module/assets/help-template.mdmarkdown623 B
shapes/multi-skill-module/assets/member-bmod-template.tomlconfig490 B
shapes/multi-skill-module/assets/record-SKILL-template.mdmarkdown374 B
shapes/multi-skill-module/assets/record-bmod-template.tomlconfig802 B
shapes/multi-skill-module/assets/retired-template.tomlconfig287 B
shapes/multi-skill-module/assets/roster-template.tomlconfig567 B
shapes/multi-skill-module/shape.mdmarkdown4.3 KB
shapes/plain-skill/assets/SKILL-template.mdmarkdown2.0 KB
shapes/plain-skill/assets/customize-template.tomlconfig1.0 KB
shapes/plain-skill/shape.mdmarkdown2.9 KB
shapes/rendered-agent/assets/SKILL-template.mdmarkdown1.0 KB
shapes/rendered-agent/assets/capability.mdmarkdown1.1 KB
shapes/rendered-agent/assets/customize-template.tomlconfig2.6 KB
shapes/rendered-agent/assets/workflow.mdmarkdown1.8 KB
shapes/rendered-agent/shape.mdmarkdown3.8 KB
shapes/rendered-skill/assets/SKILL-template.mdmarkdown1.0 KB
shapes/rendered-skill/assets/customize-template.tomlconfig990 B
shapes/rendered-skill/assets/step.mdmarkdown688 B
shapes/rendered-skill/assets/workflow.mdmarkdown1004 B
shapes/rendered-skill/shape.mdmarkdown2.2 KB
shapes/script-utility/assets/SKILL-template.mdmarkdown859 B
shapes/script-utility/assets/script-template.pyscript1.5 KB
shapes/script-utility/assets/test-template.pyscript1.2 KB
shapes/script-utility/shape.mdmarkdown1.6 KB
shapes/single-skill-module/assets/bmod-template.tomlconfig696 B
shapes/single-skill-module/assets/help-template.mdmarkdown177 B
shapes/single-skill-module/shape.mdmarkdown2.5 KB
ship.mdmarkdown6.4 KB

scripts/tests/test_memory_agent_scripts.py

View on GitHub
"""Tests for the memory-agent shape's wake and init-sanctum templates: birth, resume after a cut-off birth, and the waking map."""

import shutil
import subprocess
import sys
import tempfile
import unittest
from pathlib import Path

ASSETS = Path(__file__).resolve().parents[2] / "shapes" / "memory-agent" / "assets"
TEMPLATES = [
    "PERSONA-template.md",
    "CREED-template.md",
    "BOND-template.md",
    "HOW-I-REMEMBER-template.md",
    "CAPABILITIES-template.md",
]


def make_skill(root: Path) -> tuple[Path, Path]:
    """A built memory agent: scripts from the templates, sanctum seeds in assets/, one capability."""
    project = root / "project"
    skill = project / ".claude" / "skills" / "acme-agent-sage"
    (skill / "scripts").mkdir(parents=True)
    (skill / "assets").mkdir()
    (skill / "references").mkdir()
    shutil.copy(ASSETS / "wake-template.py", skill / "scripts" / "wake.py")
    shutil.copy(ASSETS / "init-sanctum-template.py", skill / "scripts" / "init-sanctum.py")
    for name in TEMPLATES:
        shutil.copy(ASSETS / name, skill / "assets" / name)
    (skill / "references" / "first-breath.md").write_text("birth\n", encoding="utf-8")
    (skill / "references" / "intake.md").write_text(
        "---\nname: Intake\ndescription: Keep and distill material\ncode: INTAKE\n---\n\nbody\n", encoding="utf-8"
    )
    (project / "_bmad").mkdir()
    return project, skill


def run(script: Path, *args: str) -> subprocess.CompletedProcess:
    return subprocess.run([sys.executable, str(script), *map(str, args)], capture_output=True, text=True)


class MemoryAgentScriptsTest(unittest.TestCase):
    def setUp(self):
        self._tmp = tempfile.TemporaryDirectory()
        self.project, self.skill = make_skill(Path(self._tmp.name))
        self.sanctum = self.project / "_bmad" / "memory" / "acme-agent-sage"
        self.wake = self.skill / "scripts" / "wake.py"
        self.init = self.skill / "scripts" / "init-sanctum.py"

    def tearDown(self):
        self._tmp.cleanup()

    def test_no_sanctum_routes_to_first_breath(self):
        res = run(self.wake, self.project)
        self.assertEqual(res.returncode, 0, res.stderr)
        self.assertIn("MODE: FIRST_BREATH", res.stdout)
        self.assertIn("NO SANCTUM", res.stdout)

    def test_birth_writes_the_layout_without_config(self):
        res = run(self.init, self.project, self.skill)
        self.assertEqual(res.returncode, 0, res.stderr)
        for name in ("PERSONA.md", "CREED.md", "BOND.md", "HOW-I-REMEMBER.md", "CAPABILITIES.md"):
            self.assertTrue((self.sanctum / name).is_file(), name)
        for rel in ("memory/sessions", "raw", "capabilities", "references"):
            self.assertTrue((self.sanctum / rel).is_dir(), rel)
        self.assertFalse((self.sanctum / "INDEX.md").exists())
        self.assertFalse((self.sanctum / "references" / "first-breath.md").exists())
        bond = (self.sanctum / "BOND.md").read_text(encoding="utf-8")
        self.assertNotIn("friend", bond)
        self.assertIn("learned at First Breath", bond)
        self.assertIn("| [INTAKE] | Intake |", (self.sanctum / "CAPABILITIES.md").read_text(encoding="utf-8"))

    def test_cut_off_birth_is_finished_by_the_next_run(self):
        self.sanctum.mkdir(parents=True)
        (self.sanctum / "PERSONA.md").write_text("# Persona\n\nName: Sage\n", encoding="utf-8")
        res = run(self.wake, self.project)
        self.assertIn("MODE: FIRST_BREATH", res.stdout)
        self.assertIn("INCOMPLETE SANCTUM", res.stdout)
        res = run(self.init, self.project, self.skill)
        self.assertEqual(res.returncode, 0, res.stderr)
        self.assertIn("Finished sanctum", res.stdout)
        self.assertEqual((self.sanctum / "PERSONA.md").read_text(encoding="utf-8"), "# Persona\n\nName: Sage\n")
        self.assertTrue((self.sanctum / "CREED.md").is_file())
        res = run(self.wake, self.project)
        self.assertIn("MODE: WAKING", res.stdout)

    def test_finished_sanctum_is_left_alone(self):
        run(self.init, self.project, self.skill)
        (self.sanctum / "BOND.md").write_text("# Bond\n\nCall them: Brian\n", encoding="utf-8")
        res = run(self.init, self.project, self.skill)
        self.assertEqual(res.returncode, 0, res.stderr)
        self.assertIn("already been born", res.stdout)
        self.assertIn("Call them: Brian", (self.sanctum / "BOND.md").read_text(encoding="utf-8"))

    def test_waking_prints_self_and_map_not_memory(self):
        run(self.init, self.project, self.skill)
        people = self.sanctum / "memory" / "people"
        people.mkdir()
        (people / "ruben.md").write_text("Partner. SECRET-PEOPLE-BODY\n", encoding="utf-8")
        sessions = self.sanctum / "memory" / "sessions"
        (sessions / "2026-10-01-first-breath.md").write_text("born\n", encoding="utf-8")
        (sessions / "2026-10-03-pricing.md").write_text("talked\n", encoding="utf-8")
        (self.sanctum / "memory" / "pending.md").write_text("Ask about the launch date.\n", encoding="utf-8")
        raw = self.sanctum / "raw"
        (raw / "2026-10-02-oss-call.md").write_text(
            "---\nstatus: raw\ndistilled_to: []\n---\nwords\n", encoding="utf-8"
        )
        (raw / "2026-09-30-oss-notes.md").write_text("---\nstatus: distilled\n---\nwords\n", encoding="utf-8")
        res = run(self.wake, self.project)
        self.assertEqual(res.returncode, 0, res.stderr)
        out = res.stdout
        self.assertIn("MODE: WAKING", out)
        for name in ("PERSONA.md", "CREED.md", "BOND.md", "HOW-I-REMEMBER.md", "CAPABILITIES.md"):
            self.assertIn(f"===== {name} =====", out)
        self.assertIn("memory/people/ (1 files)", out)
        self.assertIn("memory/sessions/ (2 files)", out)
        self.assertIn("raw/ (2 files)", out)
        self.assertLess(
            out.index("memory/sessions/2026-10-03-pricing.md"), out.index("memory/sessions/2026-10-01-first-breath.md")
        )
        self.assertIn("Never tended; session notes: 2", out)
        (self.sanctum / "memory" / ".tended").write_text("2026-10-02\n", encoding="utf-8")
        again = run(self.wake, self.project).stdout
        self.assertIn("Tended: 2026-10-02; session notes since: 1", again)
        self.assertIn("memory/sessions/ (2 files)", again)
        self.assertNotIn(".tended", again.split("memory map")[1].split("Tended:")[0])
        self.assertIn("Undistilled raw (1):", out)
        self.assertIn("raw/2026-10-02-oss-call.md", out)
        self.assertNotIn("2026-09-30-oss-notes.md", out.split("Undistilled raw")[1])
        self.assertIn("===== pending.md =====", out)
        self.assertIn("Ask about the launch date.", out)
        self.assertNotIn("SECRET-PEOPLE-BODY", out)

    def test_pulse_appends_pulse_file_when_present(self):
        run(self.init, self.project, self.skill)
        res = run(self.wake, self.project, "--pulse")
        self.assertIn("MODE: PULSE", res.stdout)
        self.assertNotIn("===== PULSE.md =====", res.stdout)
        (self.sanctum / "PULSE.md").write_text("# Pulse\n\ntend\n", encoding="utf-8")
        res = run(self.wake, self.project, "--pulse")
        self.assertIn("===== PULSE.md =====", res.stdout)

    def name_the_agent(self) -> None:
        run(self.init, self.project, self.skill)
        persona = self.sanctum / "PERSONA.md"
        text = persona.read_text(encoding="utf-8").replace("- **Name:** {awaiting First Breath}", "- **Name:** Bubbles")
        persona.write_text(text, encoding="utf-8")

    def test_waking_says_when_an_update_removed_the_name_from_the_description(self):
        self.name_the_agent()
        skill_md = self.skill / "SKILL.md"
        skill_md.write_text(
            "---\nname: acme-agent-sage\ndescription: 'A companion.'\n---\n# Bubbles\n", encoding="utf-8"
        )
        self.assertIn("Your name, Bubbles, is missing", run(self.wake, self.project).stdout)
        skill_md.write_text(
            "---\nname: acme-agent-sage\ndescription: 'Use when the user asks to talk to Bubbles.'\n---\n",
            encoding="utf-8",
        )
        self.assertNotIn("===== description =====", run(self.wake, self.project).stdout)

    def test_waking_leaves_an_unnamed_agent_and_a_global_install_alone(self):
        run(self.init, self.project, self.skill)
        (self.skill / "SKILL.md").write_text("---\ndescription: 'A companion.'\n---\n", encoding="utf-8")
        self.assertNotIn("===== description =====", run(self.wake, self.project).stdout)
        self.name_the_agent()
        installed = self.project.parent / "global" / self.skill.name
        shutil.copytree(self.skill, installed)
        self.assertNotIn("===== description =====", run(installed / "scripts" / "wake.py", self.project).stdout)


if __name__ == "__main__":
    unittest.main()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall