[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C8MTC8ESS4D5KFFAD1C16M":3,"skill-same:01M7C8MTC8ESS4D5KFFAD1C16M":47},{"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":27,"commitSha":28,"skillDirectory":29,"forksCount":14,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7C8MTC8ESS4D5KFFAD1C16M","ccrystal-dev-hygiene",null,"Standardized session conclusion and debrief protocol for Context Crystal developers and AI agents. Ensures causal state persistence, clean worktree\u002Fbranch hygiene across multi-forge remotes, in-flight lease defense, and zero workspace debris before session close.","oswaldo\u002Fcontext-crystal","oswaldo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F77538?v=4","01M7C8ME3V1FQD0CNJY9DV3J80","Oswaldo Dantas","01M7C8ME4KF72MVHM9ZAKD9EA0",0,"MIT","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002Fskills\u002Fccrystal-dev-hygiene\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ccrystal-dev-hygiene\ndescription: Standardized session conclusion and debrief protocol for Context Crystal developers and AI agents. Ensures causal state persistence, clean worktree\u002Fbranch hygiene across multi-forge remotes, in-flight lease defense, and zero workspace debris before session close.\nmetadata:\n  version: \"1.0\"\n  schemaVersion: \"1.0.0\"\n---\n\n# Context Crystal Developer & Session Hygiene Skill\n\nThis skill codifies the complete **Session Conclusion, Debrief & Hygiene Protocol** for human developers and AI entities working on the **Context Crystal** codebase.\n\nWhile onboarding workflows focus on session inception, this skill standardizes the equally vital ceremony of **session closure**—guaranteeing that every session leaves the repository, remote forges, causal crystals, and transient workspace resources in a clean, predictable, and zero-debris state.\n\nActivate this skill whenever a collaborator indicates: *\"let's wrap up for today\"*, *\"let's close the session\"*, *\"clean up before we leave\"*, or before tearing down an active environment.\n\n---\n\n## The Six Pillars of Session Conclosure\n\n```mermaid\nflowchart TD\n    A[\"1. Causal State & In-Flight Audit\"] --> B[\"2. Operational Learning & Memory\"]\n    B --> C[\"3. Roadmap & Milestone Alignment\"]\n    C --> D[\"4. Worktree & Clone Hygiene\"]\n    D --> E[\"5. Local & Remote Multi-Forge Git\"]\n    E --> F[\"6. Push Gate & Ephemeral Teardown\"]\n```\n\n---\n\n## Pillar 1: Causal State & In-Flight Audit\n\nNever close a session with unresolved or ambiguous crystal state:\n\n1. **Run Cave Triage:**\n   Execute `ccrystal triage` or call MCP `crystal_triage` to evaluate active crystals across the cave.\n2. **Cold Storage for Concluded Crystals:**\n   Move all concluded, completed, or superseded crystals to cold storage (`ccrystal archive \u003Cid>` or MCP `crystal_archive`) to prevent active cave bloat while preserving full DAG history and artifact lineage.\n3. **Clean Archival & In-Flight Dependency Audit:**\n   Before archiving a crystal, explicitly audit whether the session spawned **external asynchronous commitments** (e.g. upstream PRs awaiting review, third-party directory listings awaiting crawl, verification tokens) or **unregistered workspace resources** (temporary worktrees or clones):\n   - **Commitments In-Flight:** Do **NOT** archive prematurely. Keep the crystal in `in_progress` status.\n   - **Track Tasks:** Ensure open tracking tasks (`task-N`) exist for all pending external events.\n   - **Defend Leases:** Register or maintain transient resource leases (`git_worktree`, `mock_service`) to defend in-progress clones against premature deletion.\n   - **Record Checkpoint:** Append a checkpoint node (`node-N`) logging the latest status check.\n\n---\n\n## Pillar 2: Operational Learning & Memory Codification\n\nDurable insights and architectural lessons must not remain trapped in conversational transcripts:\n\n1. **Operational Learning Gate:**\n   Reflect on any friction, surprises, or new patterns discovered during the session (e.g. linker flags, API peculiarities, forge behavior).\n2. **Persistent Cognitive Memory (Vendor-Agnostic \u002F If Configured):**\n   If the collaborator or agent harness has a long-term memory or cognitive persistence mechanism configured (e.g. Engram, persistent memory scratchpad, or custom agent memory), save major architectural decisions, trade-offs, and learnings to ensure recall across future sessions.\n3. **Repository Invariants:**\n   If a learning is universal, reproducible, and relevant to the codebase, codify it directly into [AGENTS.md](AGENTS.md) or relevant skill documents. Repo-internal meta-rules belong in internal docs; user-facing changes belong in public release notes.\n\n---\n\n## Pillar 3: Roadmap & Milestone Alignment\n\nEnsure the next session can resume instantly without amnesia or priority ambiguity:\n\n1. **Review Next Steps:**\n   Inspect [conductor\u002Fnext-steps.md](conductor\u002Fnext-steps.md) and [conductor\u002Ftracks.md](conductor\u002Ftracks.md).\n2. **Reflect on Architectural Ordering:**\n   Evaluate whether recent discoveries impact future tracks (e.g. scheduling Cold Storage Purge before Cross-Crystal Connections to avoid rework).\n3. **Update Next Track Registration:**\n   Explicitly name and detail the immediate next track so that the next session can branch into a worktree and start with zero setup friction.\n\n---\n\n## Pillar 4: Worktree & Clone Lifecycle Hygiene\n\nPrevent orphaned git worktrees and auxiliary clones from consuming disk space and creating confusion:\n\n1. **Audit Active Worktrees:**\n   Run `git worktree list` from the primary repository. Ensure only persistent trees (`main`, `gh-pages`) remain.\n2. **Audit Auxiliary Worktree Directory:**\n   Inspect `..\u002Fccrystal-worktrees\u002F`:\n   - If an upstream PR has been merged or closed, safely remove the clone directory (`rm -rf ..\u002Fccrystal-worktrees\u002F\u003Cname>`).\n   - If a clone is tied to an active lease, preserve it and confirm its path matches the lease.\n3. **Never Remove Prematurely:**\n   Never prune a track worktree until its PR is merged on the remote forge and local `main` is fast-forwarded.\n\n---\n\n## Pillar 5: Local & Remote Multi-Forge Git Hygiene\n\nContext Crystal synchronizes across two upstream forges: **GitHub** (`github`) and **Codeberg** (`origin`). Both enforce protected `main` branches and require linear, PR-reviewed history:\n\n1. **Working Tree Verification:**\n   Verify `git status` across all workspaces (`context-crystal`, `context-crystal-gh-pages`). Ensure all changes are committed and cryptographically signed (`user.signingkey`).\n2. **Clean Local Merged Branches:**\n   Safely delete local branches that have merged into `main`:\n\n   ```bash\n   git branch --merged main | grep -v -E \"^\\*|main|gh-pages\" | xargs -r git branch -d\n   ```\n\n3. **Prune Stale Remote Pointers:**\n   Run `git fetch --prune github && git fetch --prune origin` so local tracking pointers drop branches already merged and deleted on the remotes.\n4. **Clean Merged Remote Branches on Codeberg & GitHub:**\n   Safely remove merged feature branches from remotes using tolerant per-branch deletion:\n\n   ```bash\n   for b in branch1 branch2; do\n     git push origin --delete \"$b\" 2>\u002Fdev\u002Fnull || true\n   done\n   ```\n\n5. **Final Remote Audit:**\n   Verify `git branch -a` shows only `main` and `gh-pages` across local and remote heads.\n\n---\n\n## Pillar 6: Operator Push Gate & Ephemeral File Teardown\n\nTo honor our **Dual-Credential Strategy & Push Gate (Cryptographic Role Separation)**:\n\n1. **Push Helper Pattern:**\n   When multiple pushes across remotes or worktrees are pending, generate a clean, executable script (`\u002Ftmp\u002Fpush_pending.sh`) with `set -euo pipefail`.\n2. **Strict Operator Confirmation:**\n   Entities must **never** execute `git push` autonomously. Instruct the operator to run the script using their locked transport key (SSH remote authentication).\n3. **Ephemeral File Teardown:**\n   Immediately after the push succeeds, remove all temporary scripts (`rm -f \u002Ftmp\u002Fpush_*.sh`). Do not leave scratch scripts in `\u002Ftmp` or the workspace.\n\n---\n\n## Quick-Reference Checklist\n\nBefore concluding any session, check off each item:\n\n- [ ] `ccrystal triage` executed; concluded crystals archived to cold storage.\n- [ ] In-flight external dependencies audited; active crystals defend transient leases.\n- [ ] Durable learnings recorded to long-term memory (if configured) and codified into docs if universal.\n- [ ] Roadmap ([conductor\u002Fnext-steps.md](conductor\u002Fnext-steps.md)) updated with next track priorities.\n- [ ] Merged clones\u002Fworktrees in `..\u002Fccrystal-worktrees\u002F` pruned.\n- [ ] Local merged branches deleted with `git branch -d`.\n- [ ] Remote branches pruned (`fetch --prune`) and dead branches deleted.\n- [ ] All workspaces committed with signed commits (`user.signingkey`).\n- [ ] Operator executed push helper with locked transport key.\n- [ ] Ephemeral helper scripts in `\u002Ftmp` destroyed.\n- [ ] Both `github` and `origin` remotes verified up to date and clean.\n","# Context Crystal Developer & Session Hygiene Skill\n\nThis skill codifies the complete **Session Conclusion, Debrief & Hygiene Protocol** for human developers and AI entities working on the **Context Crystal** codebase.\n\nWhile onboarding workflows focus on session inception, this skill standardizes the equally vital ceremony of **session closure**—guaranteeing that every session leaves the repository, remote forges, causal crystals, and transient workspace resources in a clean, predictable, and zero-debris state.\n\nActivate this skill whenever a collaborator indicates: *\"let's wrap up for today\"*, *\"let's close the session\"*, *\"clean up before we leave\"*, or before tearing down an active environment.\n\n---\n\n## The Six Pillars of Session Conclosure\n\n```mermaid\nflowchart TD\n    A[\"1. Causal State & In-Flight Audit\"] --> B[\"2. Operational Learning & Memory\"]\n    B --> C[\"3. Roadmap & Milestone Alignment\"]\n    C --> D[\"4. Worktree & Clone Hygiene\"]\n    D --> E[\"5. Local & Remote Multi-Forge Git\"]\n    E --> F[\"6. Push Gate & Ephemeral Teardown\"]\n```\n\n---\n\n## Pillar 1: Causal State & In-Flight Audit\n\nNever close a session with unresolved or ambiguous crystal state:\n\n1. **Run Cave Triage:**\n   Execute `ccrystal triage` or call MCP `crystal_triage` to evaluate active crystals across the cave.\n2. **Cold Storage for Concluded Crystals:**\n   Move all concluded, completed, or superseded crystals to cold storage (`ccrystal archive \u003Cid>` or MCP `crystal_archive`) to prevent active cave bloat while preserving full DAG history and artifact lineage.\n3. **Clean Archival & In-Flight Dependency Audit:**\n   Before archiving a crystal, explicitly audit whether the session spawned **external asynchronous commitments** (e.g. upstream PRs awaiting review, third-party directory listings awaiting crawl, verification tokens) or **unregistered workspace resources** (temporary worktrees or clones):\n   - **Commitments In-Flight:** Do **NOT** archive prematurely. Keep the crystal in `in_progress` status.\n   - **Track Tasks:** Ensure open tracking tasks (`task-N`) exist for all pending external events.\n   - **Defend Leases:** Register or maintain transient resource leases (`git_worktree`, `mock_service`) to defend in-progress clones against premature deletion.\n   - **Record Checkpoint:** Append a checkpoint node (`node-N`) logging the latest status check.\n\n---\n\n## Pillar 2: Operational Learning & Memory Codification\n\nDurable insights and architectural lessons must not remain trapped in conversational transcripts:\n\n1. **Operational Learning Gate:**\n   Reflect on any friction, surprises, or new patterns discovered during the session (e.g. linker flags, API peculiarities, forge behavior).\n2. **Persistent Cognitive Memory (Vendor-Agnostic \u002F If Configured):**\n   If the collaborator or agent harness has a long-term memory or cognitive persistence mechanism configured (e.g. Engram, persistent memory scratchpad, or custom agent memory), save major architectural decisions, trade-offs, and learnings to ensure recall across future sessions.\n3. **Repository Invariants:**\n   If a learning is universal, reproducible, and relevant to the codebase, codify it directly into [AGENTS.md](AGENTS.md) or relevant skill documents. Repo-internal meta-rules belong in internal docs; user-facing changes belong in public release notes.\n\n---\n\n## Pillar 3: Roadmap & Milestone Alignment\n\nEnsure the next session can resume instantly without amnesia or priority ambiguity:\n\n1. **Review Next Steps:**\n   Inspect [conductor\u002Fnext-steps.md](conductor\u002Fnext-steps.md) and [conductor\u002Ftracks.md](conductor\u002Ftracks.md).\n2. **Reflect on Architectural Ordering:**\n   Evaluate whether recent discoveries impact future tracks (e.g. scheduling Cold Storage Purge before Cross-Crystal Connections to avoid rework).\n3. **Update Next Track Registration:**\n   Explicitly name and detail the immediate next track so that the next session can branch into a worktree and start with zero setup friction.\n\n---\n\n## Pillar 4: Worktree & Clone Lifecycle Hygiene\n\nPrevent orphaned git worktrees and auxiliary clones from consuming disk space and creating confusion:\n\n1. **Audit Active Worktrees:**\n   Run `git worktree list` from the primary repository. Ensure only persistent trees (`main`, `gh-pages`) remain.\n2. **Audit Auxiliary Worktree Directory:**\n   Inspect `..\u002Fccrystal-worktrees\u002F`:\n   - If an upstream PR has been merged or closed, safely remove the clone directory (`rm -rf ..\u002Fccrystal-worktrees\u002F\u003Cname>`).\n   - If a clone is tied to an active lease, preserve it and confirm its path matches the lease.\n3. **Never Remove Prematurely:**\n   Never prune a track worktree until its PR is merged on the remote forge and local `main` is fast-forwarded.\n\n---\n\n## Pillar 5: Local & Remote Multi-Forge Git Hygiene\n\nContext Crystal synchronizes across two upstream forges: **GitHub** (`github`) and **Codeberg** (`origin`). Both enforce protected `main` branches and require linear, PR-reviewed history:\n\n1. **Working Tree Verification:**\n   Verify `git status` across all workspaces (`context-crystal`, `context-crystal-gh-pages`). Ensure all changes are committed and cryptographically signed (`user.signingkey`).\n2. **Clean Local Merged Branches:**\n   Safely delete local branches that have merged into `main`:\n\n   ```bash\n   git branch --merged main | grep -v -E \"^\\*|main|gh-pages\" | xargs -r git branch -d\n   ```\n\n3. **Prune Stale Remote Pointers:**\n   Run `git fetch --prune github && git fetch --prune origin` so local tracking pointers drop branches already merged and deleted on the remotes.\n4. **Clean Merged Remote Branches on Codeberg & GitHub:**\n   Safely remove merged feature branches from remotes using tolerant per-branch deletion:\n\n   ```bash\n   for b in branch1 branch2; do\n     git push origin --delete \"$b\" 2>\u002Fdev\u002Fnull || true\n   done\n   ```\n\n5. **Final Remote Audit:**\n   Verify `git branch -a` shows only `main` and `gh-pages` across local and remote heads.\n\n---\n\n## Pillar 6: Operator Push Gate & Ephemeral File Teardown\n\nTo honor our **Dual-Credential Strategy & Push Gate (Cryptographic Role Separation)**:\n\n1. **Push Helper Pattern:**\n   When multiple pushes across remotes or worktrees are pending, generate a clean, executable script (`\u002Ftmp\u002Fpush_pending.sh`) with `set -euo pipefail`.\n2. **Strict Operator Confirmation:**\n   Entities must **never** execute `git push` autonomously. Instruct the operator to run the script using their locked transport key (SSH remote authentication).\n3. **Ephemeral File Teardown:**\n   Immediately after the push succeeds, remove all temporary scripts (`rm -f \u002Ftmp\u002Fpush_*.sh`). Do not leave scratch scripts in `\u002Ftmp` or the workspace.\n\n---\n\n## Quick-Reference Checklist\n\nBefore concluding any session, check off each item:\n\n- [ ] `ccrystal triage` executed; concluded crystals archived to cold storage.\n- [ ] In-flight external dependencies audited; active crystals defend transient leases.\n- [ ] Durable learnings recorded to long-term memory (if configured) and codified into docs if universal.\n- [ ] Roadmap ([conductor\u002Fnext-steps.md](conductor\u002Fnext-steps.md)) updated with next track priorities.\n- [ ] Merged clones\u002Fworktrees in `..\u002Fccrystal-worktrees\u002F` pruned.\n- [ ] Local merged branches deleted with `git branch -d`.\n- [ ] Remote branches pruned (`fetch --prune`) and dead branches deleted.\n- [ ] All workspaces committed with signed commits (`user.signingkey`).\n- [ ] Operator executed push helper with locked transport key.\n- [ ] Ephemeral helper scripts in `\u002Ftmp` destroyed.\n- [ ] Both `github` and `origin` remotes verified up to date and clean.\n",{"name":5,"metadata":24,"description":7},{"version":25,"schemaVersion":26},"1.0","1.0.0","main","e01fe85248f9476d4a5d64e48e3381572a5bc2b3","skills\u002Fccrystal-dev-hygiene","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal","https:\u002F\u002Fgithub.com\u002Foswaldo","2026-10-22 08:41:02",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add oswaldo\u002Fcontext-crystal --skill ccrystal-dev-hygiene",{"tool":39,"command":40},"bunx","bunx skills add oswaldo\u002Fcontext-crystal --skill ccrystal-dev-hygiene",{"tool":42,"command":43},"pnpm","pnpm dlx skills add oswaldo\u002Fcontext-crystal --skill ccrystal-dev-hygiene","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002Fskills\u002Fccrystal-dev-hygiene\u002FSKILL.md",true,[],[48,54,60,67,74,79],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7C8NDE92X05P4KR3QYF8RVV","sample_runner","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002Fspec\u002Fextensions\u002Fsample_runner\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7C8NBT6K7ZP81ZA2XM3NKMH","media","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002Fspec\u002Fextensions\u002Fmedia\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7C8N6DK3BQ2DRS1GV72RF1Y","multi-channel-release","Standardized playbook and operational invariants for end-to-end multi-channel releases of Context Crystal across GitHub Releases, Maven Central (Sonatype Central Portal), Homebrew, and Coursier.","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002Fskills\u002Fmulti-channel-release\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7C8MYTPETA413VEGWBVSKKK","context-crystal","Universal agent skill for Context Crystal. Automates context lifecycle management, state transitions, session persistence, context cleavage, and prompt hydration with zero learning curve for users.","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002Fskills\u002Fcontext-crystal\u002FSKILL.md",[],[],{"skillNo":75,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7C8MPF5R7EJ10RJ6GCCNDDS","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002F.ccrystals\u002Fextensions\u002Fmedia\u002FSKILL.md",[],[],{"skillNo":80,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7C8MKMVWTX7K5N753PHFH4B","https:\u002F\u002Fgithub.com\u002Foswaldo\u002Fcontext-crystal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fmulti-channel-release\u002FSKILL.md",[],[]]