[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7504M102FQYP8MNSP92ARNB":3,"skill-same:01M7504M102FQYP8MNSP92ARNB":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7504M102FQYP8MNSP92ARNB","compaction",null,"Use when Freeflow says compaction is due or the user asks to compact: prepare what the conversation needs to continue, then compact with freeflow_compact.","hassan-mohiddin\u002Ffreeflow","hassan-mohiddin","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F63719517?v=4","01M75001RPX0N6YPMBKX9R29R3","Hassan Mohiddin","01M75001S94PQKYRZBT372B1DF",5,"MIT","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002F.skill-eval\u002Freview-suite\u002Ffixtures\u002Frs-97b149b0\u002Fseeded\u002Fworkspace\u002Ffiles\u002Fcapabilities\u002Fcompaction\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: \"compaction\"\ndescription: \"Use when Freeflow says compaction is due or the user asks to compact: prepare what the conversation needs to continue, then compact with freeflow_compact.\"\n---\n\n# Compaction\n\nCompaction replaces the conversation with what you write, and starts a new cycle: the stretch of conversation until the next compaction. The next cycle starts from your summary, the Working Record and what it points to, the carried context, and the lines Freeflow adds itself; everything else leaves your context, this skill included. Most drift after compaction comes from a summary that lost something the next step needed.\n\nThe summary works like a Working Record ([Track Work](..\u002F..\u002Fskills\u002Ftrack-work\u002FSKILL.md)) for one cycle. Ask Track Work's question: if context were lost now, what would the next context need that it could not recover from the Working Record, its defining artifacts, the workspace, or the carried context? Write that, and nothing more. Concise is not lossy: keep a detail when removing it could change the next action.\n\n## Rules\n\nThe Rules are binding; if one cannot be met, stop and say why. The rest of this skill is judgment: follow its goal, and adapt when a different choice serves it better.\n\n- With a Working Record, update it first (Track Work, \"Prepare For A Context Boundary\"), then write the summary, so the two agree. Name the record's path in the summary: Freeflow never names one, and recovery starts from it.\n- Compaction is a context boundary, not a Slice transition or a Checkpoint. Do not rush, close, or pause a Slice to compact, claim an unfinished check passed, or guess the outcome of a running operation.\n- Never write a requested, reported, or expected result as observed. Name every partial or uncommitted change, unverified result, running command, and obligation still waiting on its trigger.\n- Keep exact: paths, identifiers, commands, error text, numbers, and the user's words wherever wording matters. Never paraphrase a decision or a constraint.\n- Material that exists only in the conversation, such as a pasted file or a long message, leaves with it. With a Working Record, save it under the task's `sources\u002F` and point to it; without one, quote what matters in the summary.\n- Under Cognitive Routing with projection, the Coordinator does not compact: its view leaves out what workers did. Delegate an assignment whose contract says to compact with `freeflow_compact` and then return with `freeflow_return`, plus any other work it covers: after compacting, the worker sees the contract again but not its own `freeflow_compact` call. A worker's summary covers the whole session: the user's requests, the Coordinator's decisions, and the state of other work.\n\n## When to compact\n\nGoal: compact where stopping loses nothing that is not written down. That is a safe point: a finished step whose result you know, such as a check you ran and read, a complete set of edits, or a written report. Halfway through an edit set, with a command still running, or partway through a batch of reads you need together is not one.\n\n- At Freeflow's first notice (\"compaction is due soon\"): if you are at a safe point, compact now. If your work ends within a step or two, with a final answer or a worker's return, finish it instead. Otherwise finish the current step, start nothing large, then compact.\n- At \"compact now\", or when the user asks: the end of your current step is the safe point. If the step cannot end soon, write its partial state into the record or summary and compact. Under Cognitive Routing a worker compacts before returning: the Coordinator and the next assignment continue the same history, so a return does not stop its growth.\n\n## The summary\n\nThe previous cycle's summary is at the top of your context. Fold what still holds into the new one; drop what is done or no longer matters. Write state, not a story: what is true now, not the order things happened in. Leave out what the Working Record holds and what Freeflow states itself: the cycle, the routing profile, running background commands, and the files read and changed.\n\nRead [Summary Format](references\u002Fsummary-format.md) before writing, and use the shape that matches the work:\n\n- **With a Working Record**, the record holds the task. The record-backed shape (`Task`, `Now`, `In flight`, `Next steps`) lets a fresh context continue the current step correctly on its own; the record lets it continue the task.\n- **Without one**, the summary is the record for this cycle, in the record-shaped shape: the record's own headings.\n\nCompaction never creates a record; whether a task needs one is decided at its start or when facts change its scope.\n\nThe limit is about 8,000 tokens. Most summaries need far less. If `freeflow_compact` refuses the call, fix what it names and call it again.\n\n## What to carry\n\nThe notice gives the budget. Freeflow carries the newest results of your work in progress itself (under Cognitive Routing, those of your current assignment; otherwise, those of this cycle), filling whatever budget your picks leave, and lists the rest by ref. Pick only what that misses and the next step needs in full: older output you are working from (by routing ref, such as `ctx:1a2b3c4d`, when Cognitive Routing is on; otherwise by the id in the notice's list) and files you are changing (line ranges for large files), which are read fresh at compaction. Leave out what is cheap to re-read or already in the summary or record. The user's latest messages are carried for you. When the notice says context reuse is off, pick nothing.\n\n## After compaction\n\nThis skill leaves your context with the rest of the conversation. Freeflow's recovery message, right after the carried context, says how to recover; follow it.\n","# Compaction\n\nCompaction replaces the conversation with what you write, and starts a new cycle: the stretch of conversation until the next compaction. The next cycle starts from your summary, the Working Record and what it points to, the carried context, and the lines Freeflow adds itself; everything else leaves your context, this skill included. Most drift after compaction comes from a summary that lost something the next step needed.\n\nThe summary works like a Working Record ([Track Work](..\u002F..\u002Fskills\u002Ftrack-work\u002FSKILL.md)) for one cycle. Ask Track Work's question: if context were lost now, what would the next context need that it could not recover from the Working Record, its defining artifacts, the workspace, or the carried context? Write that, and nothing more. Concise is not lossy: keep a detail when removing it could change the next action.\n\n## Rules\n\nThe Rules are binding; if one cannot be met, stop and say why. The rest of this skill is judgment: follow its goal, and adapt when a different choice serves it better.\n\n- With a Working Record, update it first (Track Work, \"Prepare For A Context Boundary\"), then write the summary, so the two agree. Name the record's path in the summary: Freeflow never names one, and recovery starts from it.\n- Compaction is a context boundary, not a Slice transition or a Checkpoint. Do not rush, close, or pause a Slice to compact, claim an unfinished check passed, or guess the outcome of a running operation.\n- Never write a requested, reported, or expected result as observed. Name every partial or uncommitted change, unverified result, running command, and obligation still waiting on its trigger.\n- Keep exact: paths, identifiers, commands, error text, numbers, and the user's words wherever wording matters. Never paraphrase a decision or a constraint.\n- Material that exists only in the conversation, such as a pasted file or a long message, leaves with it. With a Working Record, save it under the task's `sources\u002F` and point to it; without one, quote what matters in the summary.\n- Under Cognitive Routing with projection, the Coordinator does not compact: its view leaves out what workers did. Delegate an assignment whose contract says to compact with `freeflow_compact` and then return with `freeflow_return`, plus any other work it covers: after compacting, the worker sees the contract again but not its own `freeflow_compact` call. A worker's summary covers the whole session: the user's requests, the Coordinator's decisions, and the state of other work.\n\n## When to compact\n\nGoal: compact where stopping loses nothing that is not written down. That is a safe point: a finished step whose result you know, such as a check you ran and read, a complete set of edits, or a written report. Halfway through an edit set, with a command still running, or partway through a batch of reads you need together is not one.\n\n- At Freeflow's first notice (\"compaction is due soon\"): if you are at a safe point, compact now. If your work ends within a step or two, with a final answer or a worker's return, finish it instead. Otherwise finish the current step, start nothing large, then compact.\n- At \"compact now\", or when the user asks: the end of your current step is the safe point. If the step cannot end soon, write its partial state into the record or summary and compact. Under Cognitive Routing a worker compacts before returning: the Coordinator and the next assignment continue the same history, so a return does not stop its growth.\n\n## The summary\n\nThe previous cycle's summary is at the top of your context. Fold what still holds into the new one; drop what is done or no longer matters. Write state, not a story: what is true now, not the order things happened in. Leave out what the Working Record holds and what Freeflow states itself: the cycle, the routing profile, running background commands, and the files read and changed.\n\nRead [Summary Format](references\u002Fsummary-format.md) before writing, and use the shape that matches the work:\n\n- **With a Working Record**, the record holds the task. The record-backed shape (`Task`, `Now`, `In flight`, `Next steps`) lets a fresh context continue the current step correctly on its own; the record lets it continue the task.\n- **Without one**, the summary is the record for this cycle, in the record-shaped shape: the record's own headings.\n\nCompaction never creates a record; whether a task needs one is decided at its start or when facts change its scope.\n\nThe limit is about 8,000 tokens. Most summaries need far less. If `freeflow_compact` refuses the call, fix what it names and call it again.\n\n## What to carry\n\nThe notice gives the budget. Freeflow carries the newest results of your work in progress itself (under Cognitive Routing, those of your current assignment; otherwise, those of this cycle), filling whatever budget your picks leave, and lists the rest by ref. Pick only what that misses and the next step needs in full: older output you are working from (by routing ref, such as `ctx:1a2b3c4d`, when Cognitive Routing is on; otherwise by the id in the notice's list) and files you are changing (line ranges for large files), which are read fresh at compaction. Leave out what is cheap to re-read or already in the summary or record. The user's latest messages are carried for you. When the notice says context reuse is off, pick nothing.\n\n## After compaction\n\nThis skill leaves your context with the rest of the conversation. Freeflow's recovery message, right after the carried context, says how to recover; follow it.\n",{"name":5,"description":7},"main","eda09a1c9c9e8f9119c705174eb219ea41d274d8",".skill-eval\u002Freview-suite\u002Ffixtures\u002Frs-97b149b0\u002Fseeded\u002Fworkspace\u002Ffiles\u002Fcapabilities\u002Fcompaction",0,"https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin","2026-11-15 01:37:40",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add hassan-mohiddin\u002Ffreeflow --skill compaction",{"tool":37,"command":38},"bunx","bunx skills add hassan-mohiddin\u002Ffreeflow --skill compaction",{"tool":40,"command":41},"pnpm","pnpm dlx skills add hassan-mohiddin\u002Ffreeflow --skill compaction","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002F.skill-eval\u002Freview-suite\u002Ffixtures\u002Frs-97b149b0\u002Fseeded\u002Fworkspace\u002Ffiles\u002Fcapabilities\u002Fcompaction\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Fsummary-format.md","REFERENCE","参考文档",11430,"https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002F.skill-eval\u002Freview-suite\u002Ffixtures\u002Frs-97b149b0\u002Fseeded\u002Fworkspace\u002Ffiles\u002Fcapabilities\u002Fcompaction\u002Freferences\u002Fsummary-format.md",[52,59,66,73,80,87],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M750797ZRKMXW0S0VJJZN8E7","write-skill","Use when creating, revising, merging or splitting a skill or any other text an agent acts on: a SKILL.md and its description, the references and scripts in a skill, AGENTS.md, CLAUDE.md, system or runtime prompts, tool descriptions, subagent briefs or judge prompts. Also use when deciding where an instruction should live, and when a skill is read at the wrong time, not read at all, or read but not followed.","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-skill\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7506Z3TX46QMAJKS7Y9NKJN","verify-work","Use whenever you need to know whether something works or a claim is true: running tests, builds, linters or type checks; reproducing a bug or checking a fix; trying the real path in the running software, a browser or a CLI; measuring performance; and reading what the output actually shows, including failures and conflicting results. Read it before saying a change works, is fixed or is done, and to check your own change or document before reporting it done. Also use when writing, designing or changing a test, fixture or regression check; when a claim depends on an integration, host lifecycle, an installed package, rendered UI or browser behavior, or performance; and when setting up, following or updating a project's saved steps for launching its software and trying each feature as a user would, or rechecking them after the software changed.","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002Fskills\u002Fverify-work\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7506N2HWH8F76NQ2RM74ZE3","setup-freeflow","Use when installing, activating or turning off Freeflow in a repository, changing or repairing its repository or personal configuration (.freeflow\u002Fconfig.json, .freeflow\u002Flocal.json), setting up the Freeflow store that keeps task memory (local only, or local + cloud with a private repository, in a cloud session too) and moving older task records into it, or checking whether the current host is loading Freeflow's guidance and skills.","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002Fskills\u002Fsetup-freeflow\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7506A30JCAMVJN1ZC646NJ1","research-work","Use when a question has to be answered from evidence gathered and checked first: an in-depth report on a codebase, library, agent harness or tool; a survey, literature or systematic review of papers, docs or prior work; finding out what sources say before relying on them, and rechecking a published study's numbers; a study or experiment whose plan is fixed before the data, or a quick check on about twenty tasks of whether a change helped; writing a paper from results with its figures, references and PDF, and answering its reviewers. Also use when citing code at a pinned commit, deciding how strong a claim's evidence is, checking that each number traces to its log and each citation supports its claim, designing a measurement or a model judge, and computing statistics for a result (intervals, paired comparisons, clustered runs, rater agreement, pass@k, multiple comparisons, power, meta-analysis). Comparing options from facts already in hand is Discuss Work's; checking whether a change works is Verify Work's.","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002Fskills\u002Fresearch-work\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M75064ASQQPEVVDHY23S1HKX","execute-work","Use for any task that uses tools: reading or searching a repository, running commands, diagnosing, and any work that changes code, files or settings: implementing a feature, fixing a bug, adding or changing behavior, configuring, prototyping, refactoring, simplifying or cleaning up code, deleting dead code, or maintaining a project. Also use when something fails, breaks, regresses or slows down and the cause is unknown, or a fix did not hold; when migrating users, data, a schema, a service or traffic to a replacement and removing the old path; when adding edge-case handling or code comments; and when handing work to subagents or parallel workers, or working from another agent's brief. Read it before your first tool call on a task, even a small or read-only one: it reads the request for its asks and implied requirements, finds what the change touches before you edit, and reports the result.","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002Fskills\u002Fexecute-work\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7505YQMR8ZX4X942R789XAM","evaluate-behavior","Use when testing, evaluating or comparing how an agent behaves: whether a skill triggers, whether a change to a prompt, skill, model, setting or extension changes outcomes, measuring a reviewer or checker, or benchmarking agents on coding tasks, conversations or pipelines. Also use when writing or checking an eval's JSON files, running an eval and reading its results, and deciding what a result can claim, how many cases and trials it needs and what it costs.","https:\u002F\u002Fgithub.com\u002Fhassan-mohiddin\u002Ffreeflow\u002Fblob\u002Fmain\u002Fskills\u002Fevaluate-behavior\u002FSKILL.md",[],[]]