Skill

skill-system-coder-lifecycle

Deprecated compatibility shim for canonical coder/user/auto session management. skill-system-comms is now the merged owner; this skill remains available so existing commands and imports keep working during the merge window.

Install

npx claudepluginhub arthur0824hao/skills --plugin document-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Deprecated compatibility surface. `skill-system-comms` is now the merged owner of reviewer messaging plus session lifecycle management. This skill remains as a compatibility shim during the transition.

Supporting Assets

SKILL.behavior.yamlSKILL.spec.yamlscripts/coder_lifecycle.pyscripts/test_coder_lifecycle.py

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Stars4

Forks0

Last CommitApr 8, 2026

Actions

View Source View Plugin View on GitHub View README

Skill System Coder Lifecycle

Deprecated compatibility surface. skill-system-comms is now the merged owner of reviewer messaging plus session lifecycle management. This skill remains as a compatibility shim during the transition.

This skill owns the canonical opencode session convention for projects:

coder
user
auto

It uses opencode session list --format json -n 20 for discovery, supplements that with SQLite reads from opencode.db, and never uses opencode run --title.

Commands

python3 "{skill_dir}/scripts/coder_lifecycle.py" discover <project-dir>
python3 "{skill_dir}/scripts/coder_lifecycle.py" ensure <project-dir>
python3 "{skill_dir}/scripts/coder_lifecycle.py" cleanup <project-dir>
python3 "{skill_dir}/scripts/coder_lifecycle.py" restart <project-dir> <session-name>
python3 "{skill_dir}/scripts/coder_lifecycle.py" audit

Rules

Discovery is authoritative for command decisions.
Cleanup only deletes non-canonical sessions.
Ambiguous canonical matches fail closed.
Known projects are configured in config/coder-lifecycle.yaml.

{
  "schema_version": "2.0",
  "id": "skill-system-coder-lifecycle",
  "version": "1.0.0",
  "capabilities": ["session-discover", "session-ensure", "session-cleanup", "session-restart", "session-audit"],
  "effects": ["fs.read", "db.read", "db.write", "proc.exec"],
  "operations": {
    "discover": {
      "description": "Discover canonical coder/user/auto sessions for one project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" }
      },
      "output": {
        "description": "Canonical session status plus extras",
        "fields": { "sessions": "array", "extras": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "discover", "{project_dir}"]
      }
    },
    "ensure": {
      "description": "Ensure canonical coder/user/auto sessions exist for one project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" }
      },
      "output": {
        "description": "Created sessions and final state",
        "fields": { "created": "array", "sessions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "ensure", "{project_dir}"]
      }
    },
    "cleanup": {
      "description": "Delete non-canonical sessions from one project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" }
      },
      "output": {
        "description": "Deleted extra sessions and final state",
        "fields": { "deleted": "array", "sessions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "cleanup", "{project_dir}"]
      }
    },
    "restart": {
      "description": "Restart one canonical session for a project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" },
        "session_name": { "type": "string", "required": true, "description": "Canonical session name" }
      },
      "output": {
        "description": "Restart result and final state",
        "fields": { "restarted": "boolean", "sessions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "restart", "{project_dir}", "{session_name}"]
      }
    },
    "audit": {
      "description": "Audit all known projects for session health.",
      "input": {},
      "output": {
        "description": "Session health rows by project",
        "fields": { "rows": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "audit"]
      }
    }
  },
  "stdout_contract": {
    "last_line_json": true
  }
}