Flow2Spec: Skill for Claude Code

.claude/skills/f2s-kb-fix/SKILL.md

f2s-kb-fix is a skill for Claude Code from double-coding-lab/Flow2Spec. It costs 40 tokens per session (2,346 once invoked), scanned A, original, MIT.

A repair workflow for correcting implementation or rule mistakes in a Flow2Spec project and updating its built-in knowledge base. The knowledge base stores reusable project rules and guidance.

In plain words
What is it for?
Use it after fixing code or project rules, particularly when task files, knowledge topics, revisions, or automated knowledge updates are involved.
Why use it?
It makes the corrected rule available for future work and checks for conflicts before changing shared knowledge.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: mentions subagents; mentions Codex.

This is double-coding-lab/Flow2Spec's own configuration. It tells Claude Code how to work on Flow2Spec itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything Flow2Spec configures →

Reuse

Borrowing it

Nothing to install: this file belongs to double-coding-lab/Flow2Spec. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/double-coding-lab/Flow2Spec/main/.claude/skills/f2s-kb-fix/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/double-coding-lab/Flow2Spec

Made for: Claude Code.

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 f2s-kb-fix

README.md
[![agentmods](https://agentmods.dev/badge/skills/double-coding-lab/flow2spec/f2s-kb-fix/github.svg)](https://agentmods.dev/skills/double-coding-lab/flow2spec/f2s-kb-fix)
Your own site
<a href="https://agentmods.dev/skills/double-coding-lab/flow2spec/f2s-kb-fix"><img src="https://agentmods.dev/badge/skills/double-coding-lab/flow2spec/f2s-kb-fix/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 f2s-kb-fix

Your own site · 80×15
<a href="https://agentmods.dev/skills/double-coding-lab/flow2spec/f2s-kb-fix"><img src="https://agentmods.dev/badge/skills/double-coding-lab/flow2spec/f2s-kb-fix.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 40 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,346 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.00040 $0.02346
Opus 5.5 $0.00016 $0.00938
Sonnet 5.5 $0.00008 $0.00469
Haiku 4.5 $0.00004 $0.00235

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

Security

Grade A, and why

f2s-kb-fix 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 1mo 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.

.claude/skills/f2s-kb-fix/SKILL.md · 113 lines

How it starts

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

任务路径:凡 .task/ 落盘与续作,**必须以 rules/f2s-task 解析的 TASK_ROOT 为准(.task 或 .task/<developerId>;config → git → legacy)。下文若仍出现 .task/todo.json / .task/active/,均视为 TASK_ROOT/... 的简写。

执行口径:f2s-kb-fix 默认"修代码 + 同步 .Knowledge",无需用户额外要求"请同步知识库"。

KB 自动合并协议(必须)

本技能不得把“人工执行命令”作为用户流程。修复完成后,由 agent 自己完成知识候选生成、合并、构建与校验:

  1. 将本次修复后的正确规则/实现边界转换为 kb-delta 草稿,记录 taskId、developerId、baseRevisions、changes 与修复证据;若 changeTracking.fix=true 且已有任务目录,可把 delta 落在当前 TASK_ROOT/active/<task-name>/kb-delta.json,否则可在内存中形成等价对象。changes 可使用 appendBody / replaceBody / updateFrontmatter;确需新主题时使用 createTopic,并可携带 taskRule 与 matcher 让路由一并接入。
  2. 写入 .Knowledge 前,必须用 flow2spec kb plan <delta> 或等价内部能力预演;若 topic revision 不一致,停止自动写入,转入语义合并说明。
  3. 可自动合并时,由 agent 调用 flow2spec kb apply <delta> 或等价内部能力写入 topic,并随后执行 flow2spec kb build 与 flow2spec kb check。
  4. 用户只看到“修复与知识库已同步 / 有语义冲突需确认 / 已跳过入库及原因”,不要求用户手动执行 kb plan/apply/build/check。

编排(主 / 子 agent)

  • 两字段(subAgent / switchAgentVerification)语义以统一入口为唯一事实源:Cursor/Claude 读配置根 rules/f2s-flow2spec-unified-entry.*;Codex 读 .codex/topics/f2s-flow2spec-unified-entry.md(与上同源,flow2spec init 镜像)。本处不复述。
  • 代码子包(bug 修复类实现代码):subAgent=true 时可外包给子 agent 执行。
  • 文档子包(rules / skills / topics / stock-docs 等文风类改动):默认不拆,由主 agent 直接编写,以保证「现行真值覆盖 / 篇幅上限 / 禁历史否定堆砌」等文风合规。
  • 若确需外包文档改动:子侧只输出「原位替换 diff」(before / after 小段),不得整文件重写;由主 agent 合并落盘。
  • 写权硬约束:manifest-routing.json / .Knowledge/index.md 恒由主 agent 落盘,子 agent 不得触碰。
  • 落盘侧自验。

/修正能力(f2s-kb-fix)

输入

  • 用户描述违规点、正确写法、可选范围。

步骤

步骤 0:变更追踪(仅当 changeTracking.fix: true)

执行前读取 flow2spec.config.json,若 changeTracking.fix: true:

  • 检查 .task/todo.json 是否存在活跃任务,将用户描述与 keywords 匹配。
  • 命中 → 加载对应 task.md,展示剩余清单,在已有任务中继续。
  • 无命中 → 创建新任务(见 f2s-task 规则),将步骤 1–4 写入 task.md 作为任务 checklist。
  • 执中必写盘:每完成 task.md 中一步,同一会话内立即 Edit 将该步 [ ]→[x];禁止积压打钩或口头完成代替写盘(见 f2s-task「中断与会话结束」「归档门禁」)。
  • 用户代办:凡须用户改库、配环境、回归验证等项,同会话内追加写入 .task/active/<task-name>/user-todos.md(见 f2s-task);新建任务时若无代办可写占位说明。

Read the full file on GitHub · 113 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. 1mo ago First seen · 113 lines · 40 tokens per session scan A a6c0db881412

Subscribe to this mod's changes

f2s-kb-fix is a skill published in the GitHub repository double-coding-lab/Flow2Spec (52 stars, last pushed 6d ago), licensed MIT. It adds 40 tokens to every session and 2,346 once invoked, about $0.0002 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

mem0-status

Diagnoses mem0 connectivity, API key validity, and memory read/write functionality. Use when memory operations fail, searches return empty, addmemory errors occur, or to verify the plugin is working correctly.

mem0ai/mem0 · 44 tokens

inspector-workbench

Runs Inspector UI work on the standalone Threads state lab so the agent can see the overlay. Use when a CopilotKit employee asks an agent to fix, polish, add, or debug Inspector UI, chrome, panes, overlay actions, launcher, Home, Threads, Playground, Memory, or any visual behavior in @copilotkit/web-inspector. Don't…

CopilotKit/CopilotKit · 112 tokens

md-audit

Read-only code quality audit — scan the current working directory for common issues (bugs, dead code, security hotspots, missing error handling) and return a prioritised findings report. No files are edited. Use when asked to "audit the code", "quick audit", "find issues", "code scan", or "what's wrong with this…

chaitanyagiri/munder-difflin · 85 tokens

potpie-debug-memory

Use while debugging or troubleshooting failures, flaky tests, incidents, production alerts, CI failures, local dev setup issues, repeated bugs, prior fixes, failed attempts, and verification history.

potpie-ai/potpie · 41 tokens

browserwing-admin

Manage and operate BrowserWing — an intelligent browser automation platform. Install dependencies, configure LLM, create/manage/execute automation scripts, use AI-driven exploration to generate scripts, browse the script marketplace, and troubleshoot issues.

MemTensor/MemOS · 47 tokens

code-understand

Map the load-bearing files, symbols, callers, and dependencies of an unfamiliar codebase before making changes. Use for architecture orientation, impact analysis, what-would-break questions, or finding callers. Uses CodeGraph when available and a dependency-free builtin fallback.

Ar9av/obsidian-wiki · 55 tokens