@flydocs/cli 0.6.0-alpha.13 → 0.6.0-alpha.20

package/template/flydocs/context/project.md

@@ -3,11 +3,13 @@
 ## What This Is
 
 <!-- Fill during setup: 2-3 sentences describing the project -->
+
 [Project name] — [what it does and who it's for].
 
 ## Stack
 
 <!-- Fill during setup: auto-detected or manual -->
+
 - **Framework**: [e.g., Next.js 14 / React 18]
 - **Language**: [e.g., TypeScript 5.x]
 - **Styling**: [e.g., Tailwind CSS]
@@ -20,8 +22,8 @@
 Code standards are defined by installed community skills. Skills are installed
 based on detected stack during setup or manually via `npx flydocs skills add`.
 
-Read the relevant skill before writing code in that domain. List installed skills
-with `npx flydocs skills list`.
+Installed community skills provide domain-specific patterns. List them with
+`npx flydocs skills list`.
 
 ### Project-Specific Standards
 
@@ -36,6 +38,7 @@ Project notes: `flydocs/knowledge/notes/`
 ## Active Priorities
 
 <!-- Updated by session-wrap or manually -->
+
 1. [Current priority 1]
 2. [Current priority 2]
 3. [Current priority 3]
@@ -48,4 +51,4 @@ Project notes: `flydocs/knowledge/notes/`
 
 ---
 
-*Last Updated: YYYY-MM-DD*
+_Last Updated: YYYY-MM-DD_

package/template/flydocs/design-system/README.md

@@ -6,7 +6,7 @@
 
 ## Purpose
 
-When using the `flydocs-figma` skill to extract designs, the AI needs to know:
+When using the workflow skill's Figma capabilities to extract designs, the AI needs to know:
 
 1. **How Figma tokens map to code** (colors, spacing, typography)
 2. **What component patterns exist** (and how to match them)
@@ -83,9 +83,9 @@ flydocs/design-system/
 
 ---
 
-## Integration with flydocs-figma Skill
+## Integration with Figma Workflow
 
-The `flydocs-figma` skill references this directory:
+The `flydocs-workflow` skill's Figma capabilities reference this directory:
 
 1. **Before extraction** - Loads token-mapping.md for translation rules
 2. **During extraction** - Matches Figma elements to documented patterns

package/template/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.6.0-alpha.13",
+  "version": "0.6.0-alpha.20",
   "description": "FlyDocs Core - Manifest of all managed files",
   "repository": "github.com/plastrlab/flydocs-core",
 
@@ -9,17 +9,10 @@
     "owned_directories": {
       "description": "Entire directories owned by FlyDocs - contents replaced on update",
       "paths": [
-        ".flydocs/hooks",
         ".flydocs/templates",
+        ".claude/hooks",
         ".claude/agents",
         ".claude/skills/flydocs-workflow",
-        ".claude/skills/flydocs-cloud",
-        ".claude/skills/flydocs-local",
-        ".claude/skills/flydocs-figma",
-        ".claude/skills/flydocs-estimates",
-        ".claude/skills/flydocs-context-graph",
-        ".claude/skills/flydocs-context7",
-        ".flydocs/scripts",
         ".cursor/agents"
       ]
     },
@@ -46,6 +39,7 @@
         ".claude/commands/status.md",
         ".claude/commands/validate.md",
         ".claude/commands/knowledge.md",
+        ".claude/commands/onboard.md",
         ".claude/commands/wrap-session.md",
         ".claude/skills/README.md",
         ".cursor/hooks.json",
@@ -81,6 +75,7 @@
             "statusMapping",
             "detectedStack",
             "skills",
+            "topology",
             "designSystem",
             "aiLabor"
           ]
@@ -131,6 +126,7 @@
           "implement.md",
           "knowledge.md",
           "new-project.md",
+          "onboard.md",
           "project-update.md",
           "refine.md",
           "review.md",
@@ -139,6 +135,15 @@
           "validate.md",
           "wrap-session.md"
         ],
+        "hooks": [
+          "auto-approve.py",
+          "post-edit.py",
+          "post-pr-check.py",
+          "post-transition-check.py",
+          "prompt-submit.py",
+          "session-start.py",
+          "stop-gate.py"
+        ],
         "skills": {
           "root": ["README.md"],
           "flydocs-workflow": [
@@ -147,14 +152,9 @@
             "cursor-rule.mdc",
             "stages/",
             "templates/",
-            "reference/"
-          ],
-          "flydocs-cloud": ["SKILL.md", "cursor-rule.mdc", "scripts/"],
-          "flydocs-local": ["SKILL.md", "cursor-rule.mdc", "scripts/"],
-          "flydocs-figma": ["SKILL.md", "references/"],
-          "flydocs-estimates": ["SKILL.md", "references/"],
-          "flydocs-context-graph": ["SKILL.md", "schema.md", "scripts/"],
-          "flydocs-context7": ["SKILL.md", "cursor-rule.mdc", "scripts/"]
+            "reference/",
+            "scripts/"
+          ]
         }
       },
       ".cursor": {
@@ -168,8 +168,6 @@
       },
       ".flydocs": {
         "root": ["config.json", "version", "CHANGELOG.md"],
-        "scripts": ["generate_manifest.py", "skill_manager.py"],
-        "hooks": ["auto-approve.py", "post-edit.py", "prompt-submit.py"],
         "templates": ["bug.md", "chore.md", "feature.md", "idea.md"]
       },
       "flydocs": {

package/template/.claude/skills/flydocs-cloud/SKILL.md

@@ -1,138 +0,0 @@
----
-name: flydocs-cloud
-description: |
-  Connected issue management via FlyDocs Relay API.
-  Implements the FlyDocs mechanism contract with extended cloud operations.
-  All provider translation (Linear, Jira) happens server-side.
-triggers:
-  - create issue
-  - transition
-  - comment
-  - list issues
-  - assign
-  - update description
-  - update issue
-  - project update
-  - cloud
----
-
-# FlyDocs Cloud Mechanism
-
-Issues managed via the FlyDocs Relay API. The relay handles provider translation server-side — scripts are thin REST wrappers.
-
-Reads config from `.flydocs/config.json` and API key (`FLYDOCS_API_KEY`) from `.env`.
-
-## Script Catalog
-
-All scripts: `python3 .claude/skills/flydocs-cloud/scripts/<script>`
-
-### Shared Contract Scripts
-
-| Script                  | Usage                                                                                                                                                                                                      | Output                                                                                                                                        |
-| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| `create_issue.py`       | `--title "..." --type feature [--description "..."] [--description-file PATH] [--priority N] [--estimate N] [--assignee STR] [--project ID] [--labels "a,b"] [--milestone ID_OR_NAME] [--triage] \| stdin` | `{id, identifier, title, url}`                                                                                                                |
-| `transition.py`         | `<ref> <STATUS> "<comment>"`                                                                                                                                                                               | `{success, issue, previousStatus, newStatus}`                                                                                                 |
-| `comment.py`            | `<ref> ["<comment>"] \| stdin`                                                                                                                                                                             | `{success, commentId}`                                                                                                                        |
-| `list_issues.py`        | `[--status STATUS[,STATUS]] [--active] [--project ID] [--milestone ID] [--assignee STR] [--mine] [--limit N]`                                                                                              | `[{id, identifier, title, status, assignee, priority, dueDate, milestone, milestoneId, milestoneSortOrder, project, projectId}]`              |
-| `get_issue.py`          | `<ref> [--fields basic\|full]`                                                                                                                                                                             | `{id, identifier, title, description, status, assignee, priority, estimate, dueDate, milestone, milestoneId, project, projectId, comments[]}` |
-| `assign.py`             | `<ref> <assignee> \| --unassign`                                                                                                                                                                           | `{success, issue, assignee}`                                                                                                                  |
-| `update_description.py` | `<ref> --text "..." \| --file PATH \| stdin`                                                                                                                                                               | `{success, issue}`                                                                                                                            |
-
-### Extended Scripts
-
-| Script                | Usage                                                                                                                                                                                               | Output                                                                |
-| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
-| `update_issue.py`     | `<ref> [--title "..."] [--priority N] [--estimate N] [--assignee STR] [--state STATUS] [--description "..."] [--description-file PATH] [--labels "a,b"] [--milestone ID_OR_NAME] [--comment "..."]` | `{success, issue, updated[]}`                                         |
-| `estimate.py`         | `<ref> <points>`                                                                                                                                                                                    | `{success, issue, estimate}` — relay validates against provider scale |
-| `priority.py`         | `<ref> <0-4>`                                                                                                                                                                                       | `{success, issue, priority}`                                          |
-| `link.py`             | `<ref> <related_ref> <type>`                                                                                                                                                                        | `{success, type}`                                                     |
-| `project_update.py`   | `--health STATUS --body "..." [--body-file PATH]`                                                                                                                                                   | `{success, id}`                                                       |
-| `list_projects.py`    | `[--active] [--all]`                                                                                                                                                                                | `[{id, name, state}]` — `--all` bypasses product scope                |
-| `create_project.py`   | `--name "..." [--description "..."]`                                                                                                                                                                | `{id, name, url}`                                                     |
-| `assign_cycle.py`     | `<ref> [cycle_id]`                                                                                                                                                                                  | `{success, issue, cycle}`                                             |
-| `list_cycles.py`      | `[--active]`                                                                                                                                                                                        | `[{id, name, number, startsAt, endsAt}]`                              |
-| `list_milestones.py`  | `[--all]`                                                                                                                                                                                           | `[{id, name, targetDate}]`                                            |
-| `create_milestone.py` | `--name "..." [--project ID] [--target-date DATE]`                                                                                                                                                  | `{id, name}`                                                          |
-| `update_milestone.py` | `<milestone_id> [--name "..."] [--target-date DATE] [--description "..."]`                                                                                                                          | `{success, id, name}`                                                 |
-| `delete_milestone.py` | `<milestone_id>`                                                                                                                                                                                    | `{success, id}`                                                       |
-| `assign_milestone.py` | `<ref> <milestone_id>`                                                                                                                                                                              | `{success, issue, milestone}`                                         |
-
-### Workspace Scripts
-
-| Script                  | Usage                                                                 | Output                                                                                                                |
-| ----------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| `list_providers.py`     | (no args)                                                             | `[{type, name, connected}]`                                                                                           |
-| `set_provider.py`       | `<provider_type>` (`linear` or `jira`)                                | `{success}` — updates relay routing (no local config write)                                                           |
-| `list_teams.py`         | (no args)                                                             | `[{id, name, key}]` — returns Linear teams or Jira projects (relay normalizes)                                        |
-| `create_team.py`        | `--name "..." [--key KEY] [--description "..."] [--parent <team_id>]` | `{id, name, key}` — `--parent` is Linear-only (sub-teams)                                                             |
-| `set_team.py`           | `<team_id>`                                                           | `{success}` — updates relay preference (no local config write); for Jira, sets the active Jira project                |
-| `list_labels.py`        | (no args)                                                             | `[{id, name, color}]` — requires team to be set first                                                                 |
-| `set_labels.py`         | `--defaults '["a"]' --type-map '{"feature":["F"],...}' \| stdin`      | `{success, validated, defaults, typeMap}` — stores label config on relay                                              |
-| `list_statuses.py`      | (no args)                                                             | `{states, currentMapping, flydocsStatuses}` — provider workflow states and current mapping                            |
-| `set_status_mapping.py` | `--auto \| --mapping '{"BACKLOG":"Backlog",...}' \| stdin`            | `{success, mapping, matched, total}` — stores status mapping on relay                                                 |
-| `set_identity.py`       | `<provider> <provider-user-id>`                                       | `{success, provider, providerId, meJson}` — binds provider user ID for `--mine` resolution; writes `.flydocs/me.json` |
-| `set_preferences.py`    | `[--workspace ID] [--assignee self\|ID] [--display JSON]`             | `{success, preferences}` — no flags = GET current; with flags = POST update                                           |
-| `get_estimate_scale.py` | (no args)                                                             | `{scale, type}` — provider's valid estimate values (fixed or freeform)                                                |
-| `refresh_labels.py`     | `[--fix]`                                                             | `{valid, stale, details}` — validates config label IDs against relay; `--fix` updates stale IDs                       |
-| `generate_config.py`    | `[--dry-run]`                                                         | `{success, configVersion, valid, missing[], warnings[]}` — pulls server config, merges with local, writes config.json |
-| `get_me.py`             | (no args)                                                             | `{success, displayName, email, provider, meJson}` — fetches user identity, writes `.flydocs/me.json` (no workspace)   |
-| `validate_setup.py`     | (no args)                                                             | `{valid, checks, passed[], missing[], warnings[]}` — reads relay validation, caches result, sets setupComplete        |
-
-### Script Notes
-
-- **How it works**: Scripts call the FlyDocs Relay REST API, which translates to the provider (Linear, Jira) server-side. Same interface and output as before — the transport changed from direct GraphQL to managed REST. For Jira, the relay handles Markdown-to-ADF (Atlassian Document Format) conversion automatically.
-- **Config cascade**: Setup scripts (`set_provider`, `set_team`, `set_labels`, `set_status_mapping`) only POST to the relay — they do not write local config. After all setup steps, run `generate_config.py` to pull the canonical server config and merge with local-only fields. This eliminates ghost fields and ensures config.json stays in sync with the relay.
-- **`list_issues.py --active`**: Returns all non-terminal issues (excludes Done, Archived, Canceled, Duplicate).
-- **`list_issues.py --status`**: Accepts comma-separated statuses: `--status READY,IMPLEMENTING,BLOCKED`
-- **`get_issue.py --fields basic`**: Skips comment fetch for faster responses.
-- **`update_issue.py`**: Bulk update — sets multiple fields in a single API call. Prefer over separate scripts when updating more than one field.
-- **Estimate validation**: The relay validates estimates server-side against the provider's scale. Use `get_estimate_scale.py` to discover valid values before setting. Linear uses a fixed scale `[0, 1, 2, 3, 5, 8, 13, 21]`; Jira accepts freeform values.
-- **Label staleness**: Label IDs are team-scoped and can go stale when switching teams or projects. Use `refresh_labels.py` to validate config label IDs, and `refresh_labels.py --fix` to auto-update stale ones.
-- **Shell-safe text input**: For text with special characters, pipe via stdin with a single-quoted heredoc:
-  ```bash
-  python3 update_description.py ENG-123 <<'EOF'
-  Description with 'apostrophes', (parens), and "quotes"
-  EOF
-  ```
-  Scripts supporting stdin: `update_description.py`, `comment.py`, `project_update.py`. For `update_issue.py` and `create_issue.py`, use `--description-file PATH` instead.
-
-### Status Values
-
-`BACKLOG`, `READY`, `IMPLEMENTING`, `BLOCKED`, `REVIEW`, `TESTING`, `COMPLETE`, `ARCHIVED`, `CANCELED`, `DUPLICATE`
-
-### Issue Types
-
-`feature`, `bug`, `chore`, `idea`
-
-### Link Types
-
-`blocks`, `related`, `duplicate`
-
-### Issue Reference
-
-`<ref>`: Provider identifier, e.g., `ENG-123`. Resolved server-side by the relay.
-
-## Error Handling
-
-Exit 0 = success (JSON on stdout). Exit 1 = error (message on stderr).
-Network errors: exponential backoff, 3 retries, 2s base delay.
-Relay errors include `code` and optional `provider_error` for debugging.
-
-## Configuration
-
-Reads from `.flydocs/config.json`: tier, workspaceId, relay URL override.
-Reads `FLYDOCS_API_KEY` from environment or `.env` / `.env.local`.
-
-Optional: `FLYDOCS_RELAY_URL` env var or `relay.url` in config to override the base URL (e.g., for local development).
-
-### Header Contract
-
-Every relay request includes:
-
-| Header          | Required | Source                                              |
-| --------------- | -------- | --------------------------------------------------- |
-| `Authorization` | Yes      | `Bearer fdk_...` from `FLYDOCS_API_KEY`             |
-| `X-Workspace`   | Yes\*    | `workspaceId` from `.flydocs/config.json`           |
-| `X-Repo`        | No       | Git remote slug (auto-detected, e.g., `owner/repo`) |
-
-\*Required for all endpoints except `POST /auth/validate`.

package/template/.claude/skills/flydocs-cloud/cursor-rule.mdc

@@ -1,50 +0,0 @@
----
-description: Connected issue management via FlyDocs Relay API — cloud mechanism for FlyDocs
-alwaysApply: true
----
-
-<!-- Condensed from SKILL.md — update both when changing patterns -->
-
-# FlyDocs Cloud Mechanism
-
-Issues managed via FlyDocs Relay API. Reads config from `.flydocs/config.json` and API key (`FLYDOCS_API_KEY`) from `.env`.
-
-## Shared Contract Scripts
-
-All scripts: `python3 .claude/skills/flydocs-cloud/scripts/<script>`
-
-| Script | Key Arguments |
-|--------|---------------|
-| `create_issue.py` | `--title "..." --type feature [--priority 0-4] [--estimate 1-5] [--assignee STR] [--triage]` |
-| `transition.py` | `<ref> <STATUS> "<comment>"` |
-| `comment.py` | `<ref> "<comment>"` |
-| `list_issues.py` | `[--status STATUS[,STATUS]] [--active] [--mine] [--limit N]` |
-| `get_issue.py` | `<ref> [--fields basic\|full]` |
-| `assign.py` | `<ref> <assignee>` |
-| `update_description.py` | `<ref> --text "..." \| --file PATH` |
-
-## Extended Scripts
-
-| Script | Key Arguments |
-|--------|---------------|
-| `update_issue.py` | `<ref> [--priority 0-4] [--estimate 1-5] [--assignee STR] [--state STATUS] [--comment "..."]` |
-| `project_update.py` | `--health STATUS --body "..."` |
-| `estimate.py` / `priority.py` | `<ref> <value>` |
-| `link.py` | `<ref> <related_ref> <type>` |
-| `list_projects.py` / `create_project.py` | Project management |
-| `assign_cycle.py` / `list_cycles.py` | Cycle management |
-| `assign_milestone.py` / `list_milestones.py` / `create_milestone.py` | Milestone management |
-
-## Status Values
-
-`BACKLOG`, `READY`, `IMPLEMENTING`, `BLOCKED`, `REVIEW`, `TESTING`, `COMPLETE`, `ARCHIVED`, `CANCELED`, `DUPLICATE`
-
-## Error Handling
-
-Exit 0 = success (JSON on stdout). Exit 1 = error (message on stderr).
-Network errors: exponential backoff, 3 retries, 2s base delay.
-
-## Configuration
-
-Reads from `.flydocs/config.json`: tier, relay URL override.
-Reads `FLYDOCS_API_KEY` from environment or `.env` / `.env.local`.

package/template/.claude/skills/flydocs-cloud/scripts/assign.py

@@ -1,28 +0,0 @@
-#!/usr/bin/env python3
-"""Assign or unassign an issue via the FlyDocs Relay API."""
-
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-if len(sys.argv) < 2:
-    fail("Usage: assign.py <ref> <assignee> | assign.py <ref> --unassign")
-
-ref = sys.argv[1]
-unassign = "--unassign" in sys.argv
-
-if not unassign and len(sys.argv) < 3:
-    fail("Usage: assign.py <ref> <assignee> | assign.py <ref> --unassign")
-
-assignee = None if unassign else sys.argv[2]
-client = get_client()
-
-result = client.post(f"/issues/{ref}/assign", {"assignee": assignee})
-
-output_json({
-    "success": result.get("success", True),
-    "issue": result.get("issue", ref),
-    "assignee": result.get("assignee", assignee),
-})

package/template/.claude/skills/flydocs-cloud/scripts/assign_cycle.py

@@ -1,28 +0,0 @@
-#!/usr/bin/env python3
-"""Assign a cycle to an issue via the FlyDocs Relay API."""
-
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-if len(sys.argv) < 2:
-    fail("Usage: assign_cycle.py <ref> [cycle_id]")
-
-ref = sys.argv[1]
-cycle_id = sys.argv[2] if len(sys.argv) >= 3 else None
-
-client = get_client()
-
-body: dict = {}
-if cycle_id:
-    body["cycleId"] = cycle_id
-
-result = client.put(f"/issues/{ref}/cycle", body)
-
-output_json({
-    "success": result.get("success", True),
-    "issue": result.get("issue", ref),
-    "cycle": result.get("cycle", ""),
-})

package/template/.claude/skills/flydocs-cloud/scripts/assign_milestone.py

@@ -1,22 +0,0 @@
-#!/usr/bin/env python3
-"""Assign a milestone to an issue via the FlyDocs Relay API."""
-
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-if len(sys.argv) < 3:
-    fail("Usage: assign_milestone.py <ref> <milestone_id>")
-
-ref, milestone_id = sys.argv[1], sys.argv[2]
-client = get_client()
-
-result = client.put(f"/issues/{ref}/milestone", {"milestoneId": milestone_id})
-
-output_json({
-    "success": result.get("success", True),
-    "issue": result.get("issue", ref),
-    "milestone": result.get("milestone", ""),
-})

package/template/.claude/skills/flydocs-cloud/scripts/comment.py

@@ -1,29 +0,0 @@
-#!/usr/bin/env python3
-"""Add a comment to an issue via the FlyDocs Relay API."""
-
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-if len(sys.argv) < 2:
-    fail("Usage: comment.py <ref> [comment] | stdin")
-
-ref = sys.argv[1]
-
-# Comment from arg > stdin
-if len(sys.argv) >= 3:
-    body = sys.argv[2]
-elif not sys.stdin.isatty():
-    body = sys.stdin.read().strip()
-else:
-    fail("Provide comment as argument or via stdin")
-
-client = get_client()
-result = client.post(f"/issues/{ref}/comment", {"body": body})
-
-output_json({
-    "success": result.get("success", True),
-    "commentId": result.get("commentId", ""),
-})

package/template/.claude/skills/flydocs-cloud/scripts/create_issue.py

@@ -1,83 +0,0 @@
-#!/usr/bin/env python3
-"""Create a new issue via the FlyDocs Relay API."""
-
-import argparse
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Create issue")
-    parser.add_argument("--title", required=True)
-    parser.add_argument("--type", required=True, choices=["feature", "bug", "chore", "idea"], dest="issue_type")
-    parser.add_argument("--description", default="")
-    parser.add_argument("--description-file", default="", dest="description_file")
-    parser.add_argument("--priority", type=int, default=3, help="Priority (0-4, relay translates per provider)")
-    parser.add_argument("--estimate", type=int, default=0, help="Estimate points (relay translates per provider)")
-    parser.add_argument("--assignee", default=None)
-    parser.add_argument("--project", default=None, help="Project ID")
-    parser.add_argument("--labels", default=None, help="Comma-separated ad-hoc label names")
-    parser.add_argument("--milestone", default=None, help="Milestone ID or name (resolved by name lookup)")
-    parser.add_argument("--triage", action="store_true")
-    args = parser.parse_args()
-
-    # Resolve description: --description-file > stdin > --description
-    description = args.description
-    if args.description_file:
-        try:
-            description = Path(args.description_file).read_text()
-        except FileNotFoundError:
-            fail(f"File not found: {args.description_file}")
-    elif not description and not sys.stdin.isatty():
-        description = sys.stdin.read().strip()
-
-    body: dict = {
-        "title": args.title,
-        "type": args.issue_type,
-        "priority": args.priority,
-    }
-    if description:
-        body["description"] = description
-    if args.estimate:
-        body["estimate"] = args.estimate
-    if args.assignee:
-        body["assignee"] = args.assignee
-    if args.project:
-        body["projectId"] = args.project
-    if args.labels:
-        body["labels"] = [l.strip() for l in args.labels.split(",") if l.strip()]
-    if args.triage:
-        body["triage"] = True
-
-    client = get_client()
-
-    if args.milestone:
-        milestone_id = args.milestone
-        # If it doesn't look like a UUID, resolve by name
-        if len(milestone_id) != 36 or "-" not in milestone_id:
-            milestones = client.get("/milestones")
-            match = None
-            for m in milestones:
-                if m["name"].lower() == milestone_id.lower():
-                    match = m
-                    break
-            if not match:
-                fail(f"Milestone not found: {milestone_id}")
-            milestone_id = match["id"]
-        body["milestoneId"] = milestone_id
-
-    result = client.post("/issues", body)
-
-    output_json({
-        "id": result["id"],
-        "identifier": result["identifier"],
-        "title": result["title"],
-        "url": result["url"],
-    })
-
-
-if __name__ == "__main__":
-    main()

package/template/.claude/skills/flydocs-cloud/scripts/create_milestone.py

@@ -1,35 +0,0 @@
-#!/usr/bin/env python3
-"""Create a milestone via the FlyDocs Relay API."""
-
-import argparse
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Create milestone")
-    parser.add_argument("--name", required=True)
-    parser.add_argument("--project", default=None, help="Project ID")
-    parser.add_argument("--target-date", default=None, dest="target_date")
-    args = parser.parse_args()
-
-    body: dict = {"name": args.name}
-    if args.project:
-        body["projectId"] = args.project
-    if args.target_date:
-        body["targetDate"] = args.target_date
-
-    client = get_client()
-    result = client.post("/milestones", body)
-
-    output_json({
-        "id": result["id"],
-        "name": result["name"],
-    })
-
-
-if __name__ == "__main__":
-    main()

package/template/.claude/skills/flydocs-cloud/scripts/create_project.py

@@ -1,33 +0,0 @@
-#!/usr/bin/env python3
-"""Create a project via the FlyDocs Relay API."""
-
-import argparse
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json, fail
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Create project")
-    parser.add_argument("--name", required=True)
-    parser.add_argument("--description", default=None)
-    args = parser.parse_args()
-
-    body: dict = {"name": args.name}
-    if args.description:
-        body["description"] = args.description
-
-    client = get_client()
-    result = client.post("/projects", body)
-
-    output_json({
-        "id": result["id"],
-        "name": result["name"],
-        "url": result.get("url", ""),
-    })
-
-
-if __name__ == "__main__":
-    main()

package/template/.claude/skills/flydocs-cloud/scripts/create_team.py

@@ -1,39 +0,0 @@
-#!/usr/bin/env python3
-"""Create a team/project via the FlyDocs Relay API."""
-
-import argparse
-import sys
-from pathlib import Path
-
-sys.path.insert(0, str(Path(__file__).parent))
-from flydocs_api import get_client, output_json
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Create team or project")
-    parser.add_argument("--name", required=True)
-    parser.add_argument("--key", default=None, help="Team key (e.g., PROD). Auto-generated if omitted.")
-    parser.add_argument("--description", default=None)
-    parser.add_argument("--parent", default=None, dest="parent_id", help="Parent team ID for sub-team (Linear only, ignored for Jira)")
-    args = parser.parse_args()
-
-    body: dict = {"name": args.name}
-    if args.key:
-        body["key"] = args.key
-    if args.description:
-        body["description"] = args.description
-    if args.parent_id:
-        body["parentId"] = args.parent_id
-
-    client = get_client()
-    result = client.post("/teams", body)
-
-    output_json({
-        "id": result["id"],
-        "name": result["name"],
-        "key": result.get("key", ""),
-    })
-
-
-if __name__ == "__main__":
-    main()