feat: bootstrap workon-skill project

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: nicholasadamou

.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  markdown:
+    name: Markdown
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: DavidAnson/markdownlint-cli2-action@v20
+        with:
+          globs: |
+            **/*.md
+
+  skill-validation:
+    name: Skill Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Validate SKILL frontmatter
+        run: |
+          python - <<'PY'
+          from pathlib import Path
+          import re
+          import sys
+
+          skill_path = Path("SKILL.md")
+          if not skill_path.exists():
+              print("SKILL.md is missing")
+              sys.exit(1)
+
+          text = skill_path.read_text(encoding="utf-8")
+          match = re.match(r"^---\n(.*?)\n---\n", text, flags=re.DOTALL)
+          if not match:
+              print("SKILL.md must start with YAML frontmatter delimited by ---")
+              sys.exit(1)
+
+          frontmatter = match.group(1)
+          keys = {}
+          for line in frontmatter.splitlines():
+              if ":" not in line:
+                  continue
+              k, v = line.split(":", 1)
+              keys[k.strip()] = v.strip().strip('"').strip("'")
+
+          required = ["name", "description", "argument-hint"]
+          missing = [k for k in required if not keys.get(k)]
+          if missing:
+              print(f"Missing required frontmatter keys: {', '.join(missing)}")
+              sys.exit(1)
+
+          print("SKILL.md frontmatter validation passed")
+          PY

.gitignore

@@ -0,0 +1 @@
+.DS_Store

AGENTS.md

@@ -0,0 +1,34 @@
+# AGENTS.md
+
+Guidance for agents working in `workon-skill`.
+
+## Scope
+
+This repository contains a single portable skill spec for `/workon`.
+Keep changes focused on:
+
+- `SKILL.md` behavior and wording
+- documentation clarity in `README.md`
+- portability across environments (no company-internal assumptions)
+
+```mermaid
+flowchart TD
+  S[Setup] --> W[Watch]
+  W -->|PR merged| T[Teardown]
+  W -->|PR open| W
+```
+
+## Rules
+
+- Keep branding generic and open-source friendly.
+- Prefer explicit idempotency and recovery behavior.
+- Do not hardcode environment-specific defaults when they can be discovered.
+- Keep human-facing updates concise and free of internal jargon.
+
+## Validation
+
+Before finishing, verify:
+
+1. `SKILL.md` frontmatter is valid and complete.
+2. All references are generic (no company-internal feedback doc references).
+3. The setup/watch/teardown flow remains consistent and re-entrant.

LICENSE

@@ -0,0 +1,27 @@
+PolyForm Shield License 1.0.0
+
+Copyright (c) 2026 dotbrains
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, and distribute the Software, subject to the following conditions:
+
+1. You may not use the Software to provide a product or service that competes
+   with the Software or any product or service offered by the Licensor that
+   includes the Software.
+
+2. You may not remove or obscure any licensing, copyright, or other notices
+   included in the Software.
+
+3. If you distribute the Software or any derivative works, you must include a
+   copy of this license.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+For more information, see https://polyformproject.org/licenses/shield/1.0.0

README.md

@@ -0,0 +1,47 @@
+# workon-skill
+
+[![License: PolyForm Shield](https://img.shields.io/badge/License-PolyForm%20Shield-brightgreen.svg)](https://polyformproject.org/licenses/shield/1.0.0)
+
+Portable `/workon` skill for Linear-driven ticket execution:
+
+1. Create an isolated worktree.
+2. Implement and open a PR.
+3. Watch PR health in a loop (AI review comments, CI, merge conflicts).
+4. Tear down the worktree after merge.
+
+```mermaid
+flowchart LR
+  A[Setup] --> B[Implement + PR]
+  B --> C[Watch Loop]
+  C --> D{Merged?}
+  D -- No --> C
+  D -- Yes --> E[Teardown]
+```
+
+## Repository layout
+
+- `SKILL.md` — canonical skill definition
+- `AGENTS.md` — contributor guidance for AI and human maintainers
+
+## Usage
+
+One-line install:
+
+```bash
+mkdir -p ~/.claude/skills/workon && curl -fsSL https://raw.githubusercontent.com/dotbrains/workon-skill/main/SKILL.md -o ~/.claude/skills/workon/SKILL.md
+```
+
+Install `SKILL.md` in your skills path, then invoke:
+
+```text
+/workon ENG-66
+```
+
+The skill is idempotent and stateful, so repeated invocations resume from the current phase.
+
+## Requirements
+
+- `git`
+- `gh` CLI authenticated against your GitHub host
+- Linear access (MCP integration or equivalent API tooling)
+- Loop scheduler support (for 5-minute watch ticks)