Шесть скиллов
Claude Code и Cursor показывают имена по-разному. Claude Code добавляет имя плагина, например floppy:start. Cursor показывает короткое имя, например /start, а плагин отображает как «Created by Floppy». Этот документ использует короткое имя. Только короткое имя верно в обоих приложениях.
init— настройка. См. Установка и init.agent-memory— правила для памяти. У этого скилла нет шагов. Остальные скиллы этим правилам подчиняются. Одна заметка содержит один факт. У каждой заметки есть полеmetadata.evidenceс одним из значений:measured,read,decided,sourced. У индекса три уровня:MEMORY.md, затем<half>/INDEX.md, затем<half>/<group>/INDEX.md. Файлquota.lockдержит ограничения размера. Каждый факт принадлежит одной области: проект, кросс-проект, рабочее место или машина. Факт, верный больше чем для одного проекта, идёт в кросс-проектную областьcommon/, которую память подключает по одной ссылке на аудиторию. Заметка пишется в момент появления факта, а не собирается в конце сессии.start— готовит новую сессию, до первой правки. Агент читает файл состояния. Затем агент находит половину памяти, относящуюся к этой задаче, и читает руководство и индекс этой половины. Если памяти в репозитории ещё нет, агент этот шаг пропускает. Затем агент выполняетbash <plugin>/scripts/run status, потому что живые факты надёжнее документов.workstatus— докладывает состояние по ходу сессии: состояние git, расхождение с удалённым, фоновые задачи, конфигурацию памяти, репозиторий памяти рабочего места и возраст файла состояния.wrap— закрывает сессию. Агент берёт замок. Большая часть фактов уже записана заметками в момент их появления; здесь агент добавляет только то, что осталось, обновляет файл состояния и записывает незавершённую работу. Затем агент выполняетbash <plugin>/scripts/run check, который ничего не меняет и показывает результат линта, проверку списка файлов и дифф. Последним агент выполняетbash <plugin>/scripts/run commit, который индексирует, коммитит, пушит и освобождает замок.consolidate— сливает и чистит память, когда срабатывает предупреждение о размере, или перед поднятием лимита вquota.lock. Агент читает одну половину памяти, предлагает слияния, переписывания и удаления, каждое с причиной, и применяет только то, что человек утвердил. Если память после этого умещается в лимит, лимит не поднимается. Пустой результат — тоже результат: именно его тогда записывает коммит с поднятием.
Что каждый скилл говорит о себе
Блок ниже собирается при сборке сайта из поля description файла skills/<name>/SKILL.md. Он остаётся английским: эти файлы читает модель, и их формулировки — это поведение, а не текст для чтения. Поэтому страница не может описать скилл иначе, чем его видит агент.
init
Lay the floppy memory out in this repository — write .floppy/config, create the memory skeleton, gitignore the local scope, and point AGENTS.md at agent-memory. Idempotent, safe to run again. Use once per repository, when setting the plugin up for the first time, or when the user asks to init, set up, or bootstrap floppy here.
agent-memory
Conventions for the durable session memory this toolkit keeps — one fact per file, the moment a note gets written, note frontmatter and metadata.evidence, the three-level index tree, the quota.lock ratchet, and which of project/cross-project/workplace/machine scope a fact belongs to. Load this before writing, moving, or reorganizing a memory note, or whenever start/workstatus/wrap need the ground rules — they assume these conventions rather than restate them.
start
Orient a fresh session before touching any file — read the current-state file, the relevant half’s own guidance, and that half’s memory index, then verify live facts with the plugin’s own status verb instead of trusting the documents. Use at the start of a session, when picking up a new task or branch of work, or when the user asks to start, orient, or “what’s next”.
workstatus
Report what is true right now, checked live rather than recalled — retells the plugin’s own status verb and names what is waiting on the human. Use mid-session for “where are we”, a live status check, before answering a question about current state, or when the user asks for workstatus.
wrap
Close a session — select the facts worth keeping into memory, update the current-state file, name what’s left unfinished, then check and commit through the plugin’s own verbs. Use when a session is ending, context is about to be cleared, or the user asks to wrap up.
consolidate
Merge, rewrite, and prune the memory one half at a time — proposes each change with its evidence and applies only what the human approves. Use when lint warns a ceiling is near, before raising any quota.lock number, or when the user asks to consolidate, tidy, or prune the memory.