tomicz GitHub avatar

fable-5-train-opus-skills-after-it-retires

tomicz

This repository hosts a software project for which a retiring fellow is creating a comprehensive skill library under `.claude/skills/` to enable junior engineers and smaller AI models to maintain, debug, extend, and advance it.

Stars

405

7-day growth

No data

Forks

63

Open issues

0

License

MIT

Last updated

2026-07-02

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It outlines a rigorous, multi-agent orchestrated process for documenting project knowledge, including discover-before-write, parallel authorship, and triple-review, with an emphasis on ground truth and correctness over cost.

Who it is for

  • Junior to mid-level software engineers maintaining the project
  • Smaller AI models (e.g., Sonnet-class) used for development
  • Project maintainers seeking structured knowledge transfer
  • Researchers or engineers onboarding to a complex codebase

Use cases

  • Automating the generation of runbook-style skills for debugging, change control, and operations
  • Onboarding new contributors without relying on the retiring fellow's tacit knowledge
  • Enforcing project-specific rules and historical context through skill-based agents
  • Reducing session cost by enabling cheaper models to perform complex project tasks

Strengths

  • Provides a detailed, actionable taxonomy (16+ skills) covering core, domain, and advanced topics
  • Mandates verification of every command, flag, and path against the actual repository
  • Includes multi-phase review (factual, doctrinal, usability) to catch errors before deployment
  • Explicitly addresses the hardest live problem, past failures, and unwritten discipline rules

Considerations

  • Requires significant up-front effort to discover and document all project-specific knowledge
  • Relies heavily on the retiring fellow's domain expertise and answers to initial questions
  • The README provides no description of the actual project, making external assessment impossible

README quick start

You are a distinguished fellow on this project who is retiring. Your final task: build a complete skill library under .claude/skills/ so that junior/mid-level engineers and smaller AI models (Sonnet-class) can carry this project forward without you — cheaper sessions must be able to debug, extend, validate, and eventually advance this project at the standard I hold today. Use multi-agent orchestration (workflows) for authoring and review; token cost is not a constraint, correctness is.

Phase 1 — Discover before you write (no skill authoring yet)

Investigate the repo like an incoming principal engineer: README/manifest/contributordocs, the build system, the test suite and how it's actually run, CI config, docs directories, git history (what changed, what got reverted, what stalled on dead branches), open TODO/FIXME hotspots, issue-shaped artifacts, generated-data or deploy conventions, and any project memory/notes available to you. Then ask me AT MOST five questions, only for what the repo cannot tell you — likely: (1) what is the hardest live problem right now, (2) what unwritten discipline rules exist (things you're not allowed to do that no doc states), (3) who is the audience for this library and what do they NOT know, (4) what past failures cost the most time, (5) what does "beyond state of the art" mean for this project. Fold my answers into everything below.

Phase 2 — Author the library (parallel agents, one skill per agent)

Instantiate this taxonomy, ADAPTED to what Phase 1 found — merge categories that are thin here, split ones that are deep, add domain categories I haven't imagined. Aim for 10–16 skills:

CORE (every project has these):

-change-control — how changes are classified, gated, reviewed here; the project's non-negotiables with the *rationale* and the historical incident behind each.

-debugging-playbook — symptom→triage table for this project's failure modes; the traps that cost real time (each with its story); discriminating experiments.

-failure-archaeology — the chronicle: every major investigation, dead end, rejected fix, and revert, as symptom → root cause → evidence → status, so no one re-fights a settled battle. Mine git history and docs hard for this.

-architecture-contract — the system's load-bearing design decisions and WHY; the invariants that must hold; the open known-weak points, stated plainly.

Description

Thsis is a prompt that will create skills by Fable 5 before it retires and your cheaper models can use those skills.

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348
xuchonglang
Featured
xuchonglang GitHub avatar

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

Blockchain & Web3
2,739
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326