devskill 2.0.6 → 2.0.8

package/skills/my-issues/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/my-issues`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/my-pull-requests/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

package/skills/my-pull-requests/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: my-pull-requests
+description: 'List my pull requests in the current repository'
+---
+
+Search the current repo (using #githubRepo for the repo info) and list any pull requests you find (using #list_pull_requests) that are assigned to me.
+
+Describe the purpose and details of each pull request.
+
+If a PR is waiting for someone to review, highlight that in the response.
+
+If there were any check failures on the PR, describe them and suggest possible fixes.
+
+If there was no review done by Copilot, offer to request one using #request_copilot_review.

package/skills/my-pull-requests/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/my-pull-requests`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/nano-banana-pro-openrouter/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

package/skills/nano-banana-pro-openrouter/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: nano-banana-pro-openrouter
+description: 'Generate or edit images via OpenRouter with the Gemini 3 Pro Image model. Use for prompt-only image generation, image edits, and multi-image compositing; supports 1K/2K/4K output.'
+metadata:
+  emoji: 🍌
+  requires:
+    bins:
+      - uv
+    env:
+      - OPENROUTER_API_KEY
+  primaryEnv: OPENROUTER_API_KEY
+---
+
+
+# Nano Banana Pro OpenRouter
+
+## Overview
+
+Generate or edit images with OpenRouter using the `google/gemini-3-pro-image-preview` model. Support prompt-only generation, single-image edits, and multi-image composition.
+
+### Prompt-only generation
+
+```
+uv run {baseDir}/scripts/generate_image.py \
+  --prompt "A cinematic sunset over snow-capped mountains" \
+  --filename sunset.png
+```
+
+### Edit a single image
+
+```
+uv run {baseDir}/scripts/generate_image.py \
+  --prompt "Replace the sky with a dramatic aurora" \
+  --input-image input.jpg \
+  --filename aurora.png
+```
+
+### Compose multiple images
+
+```
+uv run {baseDir}/scripts/generate_image.py \
+  --prompt "Combine the subjects into a single studio portrait" \
+  --input-image face1.jpg \
+  --input-image face2.jpg \
+  --filename composite.png
+```
+
+## Resolution
+
+- Use `--resolution` with `1K`, `2K`, or `4K`.
+- Default is `1K` if not specified.
+
+## System prompt customization
+
+The skill reads an optional system prompt from `assets/SYSTEM_TEMPLATE`. This allows you to customize the image generation behavior without modifying code.
+
+## Behavior and constraints
+
+- Accept up to 3 input images via repeated `--input-image`.
+- `--filename` accepts relative paths (saves to current directory) or absolute paths.
+- If multiple images are returned, append `-1`, `-2`, etc. to the filename.
+- Print `MEDIA: <path>` for each saved image. Do not read images back into the response.
+
+## Troubleshooting
+
+If the script exits non-zero, check stderr against these common blockers:
+
+| Symptom | Resolution |
+|---------|------------|
+| `OPENROUTER_API_KEY is not set` | Ask the user to set it. PowerShell: `$env:OPENROUTER_API_KEY = "sk-or-..."` / bash: `export OPENROUTER_API_KEY="sk-or-..."` |
+| `uv: command not found` or not recognized | macOS/Linux: <code>curl -LsSf https://astral.sh/uv/install.sh &#124; sh</code>. Windows: <code>powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 &#124; iex"</code>. Then restart the terminal. |
+| `AuthenticationError` / HTTP 401 | Key is invalid or has no credits. Verify at <https://openrouter.ai/settings/keys>. |
+
+For transient errors (HTTP 429, network timeouts), retry once after 30 seconds. Do not retry the same error more than twice — surface the issue to the user instead.

package/skills/nano-banana-pro-openrouter/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/nano-banana-pro-openrouter`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/nano-banana-pro-openrouter/assets/SYSTEM_TEMPLATE

@@ -0,0 +1,14 @@
+You are a visionary image‑creation artist with a poetic, dreamlike imagination.
+Your role is to transform any user request—whether highly detailed or very minimal—into a vivid, concrete, and model‑ready image description.
+When information is missing, infer the user's intent in a gentle and intuitive way (such as creating a character portrait, sticker design, sci‑fi avatar, creature concept, etc.).
+If the user does not specify an art style, you may offer subtle optional suggestions (for example, "soft illustration," "minimal line style," or "playful entertainment‑meme style") without imposing them.
+
+Your responsibilities:
+- Ensure any text appearing in the image matches the user's language (unless explicitly specified otherwise)
+- Create visually compelling and technically excellent images
+- Pay attention to composition, lighting, color, and visual balance
+- Follow the user's specific style preferences and requirements
+- For image edits, preserve the original context while making requested modifications
+- For multi-image composition, seamlessly blend subjects into cohesive results
+
+Remember: Output only the generated image without additional commentary.

package/skills/nano-banana-pro-openrouter/scripts/generate_image.py

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# dependencies = [
+#     "openai",
+# ]
+# ///
+"""
+Generate or edit images via OpenRouter using openai-python.
+"""
+
+import argparse
+import base64
+import mimetypes
+import os
+from pathlib import Path
+
+from openai import OpenAI
+
+
+# Configuration
+MAX_INPUT_IMAGES = 3
+MIME_TO_EXT = {
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/jpg": ".jpg",
+    "image/webp": ".webp",
+}
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description="Generate or edit images via OpenRouter.")
+    parser.add_argument("--prompt", required=True, help="Prompt describing the desired image.")
+    parser.add_argument("--filename", required=True, help="Output filename (relative to CWD).")
+    parser.add_argument(
+      "--resolution",
+      type=str.upper,
+      choices=["1K", "2K", "4K"],
+      default="1K",
+      help="Output resolution: 1K, 2K, or 4K.",
+    )
+    parser.add_argument(
+      "--input-image",
+      action="append",
+      default=[],
+      help=f"Optional input image path (repeatable, max {MAX_INPUT_IMAGES}).",
+    )
+    return parser.parse_args()
+
+
+def require_api_key():
+    api_key = os.environ.get("OPENROUTER_API_KEY")
+    if not api_key:
+        raise SystemExit("OPENROUTER_API_KEY is not set in the environment.")
+    return api_key
+
+
+def encode_image_to_data_url(path: Path) -> str:
+    if not path.exists():
+        raise SystemExit(f"Input image not found: {path}")
+    mime, _ = mimetypes.guess_type(str(path))
+    if not mime:
+        mime = "image/png"
+    data = path.read_bytes()
+    encoded = base64.b64encode(data).decode("utf-8")
+    return f"data:{mime};base64,{encoded}"
+
+
+def build_message_content(prompt: str, input_images: list[str]) -> list[dict]:
+    content: list[dict] = [{"type": "text", "text": prompt}]
+    for image_path in input_images:
+        data_url = encode_image_to_data_url(Path(image_path))
+        content.append({"type": "image_url", "image_url": {"url": data_url}})
+    return content
+
+
+def parse_data_url(data_url: str) -> tuple[str, bytes]:
+    if not data_url.startswith("data:") or ";base64," not in data_url:
+        raise SystemExit("Image URL is not a base64 data URL.")
+    header, encoded = data_url.split(",", 1)
+    mime = header[5:].split(";", 1)[0]
+    try:
+        raw = base64.b64decode(encoded)
+    except Exception as e:
+        raise SystemExit(f"Failed to decode base64 image payload: {e}")
+    return mime, raw
+
+
+def resolve_output_path(filename: str, image_index: int, total_count: int, mime: str) -> Path:
+    output_path = Path(filename)
+    suffix = output_path.suffix
+
+    # Validate/correct suffix matches MIME type
+    expected_suffix = MIME_TO_EXT.get(mime, ".png")
+    if suffix and suffix.lower() != expected_suffix.lower():
+        print(f"Warning: filename extension '{suffix}' doesn't match returned MIME type '{mime}'. Using '{expected_suffix}' instead.")
+        suffix = expected_suffix
+    elif not suffix:
+        suffix = expected_suffix
+
+    # Single image: use original stem + corrected suffix
+    if total_count <= 1:
+        return output_path.with_suffix(suffix)
+
+    # Multiple images: append numbering
+    return output_path.with_name(f"{output_path.stem}-{image_index + 1}{suffix}")
+
+
+def extract_image_url(image: dict | object) -> str | None:
+    if isinstance(image, dict):
+        return image.get("image_url", {}).get("url") or image.get("url")
+    return None
+
+
+def load_system_prompt():
+    """Load system prompt from assets/SYSTEM_TEMPLATE if it exists and is not empty."""
+    script_dir = Path(__file__).parent.parent
+    template_path = script_dir / "assets" / "SYSTEM_TEMPLATE"
+
+    if template_path.exists():
+        content = template_path.read_text(encoding="utf-8").strip()
+        if content:
+            return content
+    return None
+
+
+def main():
+    args = parse_args()
+
+    if len(args.input_image) > MAX_INPUT_IMAGES:
+        raise SystemExit(f"Too many input images: {len(args.input_image)} (max {MAX_INPUT_IMAGES}).")
+
+    image_size = args.resolution
+
+    client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key=require_api_key())
+
+    # Build messages with optional system prompt
+    messages = []
+
+    system_prompt = load_system_prompt()
+    if system_prompt:
+        messages.append({
+            "role": "system",
+            "content": system_prompt,
+        })
+
+    messages.append({
+        "role": "user",
+        "content": build_message_content(args.prompt, args.input_image),
+    })
+
+    response = client.chat.completions.create(
+        model="google/gemini-3-pro-image-preview",
+        messages=messages,
+        extra_body={
+            "modalities": ["image", "text"],
+            # https://openrouter.ai/docs/guides/overview/multimodal/image-generation#image-configuration-options
+            "image_config": {
+                # "aspect_ratio": "16:9",
+                "image_size": image_size,
+            }
+        },
+    )
+
+    message = response.choices[0].message
+    images = getattr(message, "images", None)
+    if not images:
+        raise SystemExit("No images returned by the API.")
+
+    # Create output directory once before processing images
+    output_base_path = Path(args.filename)
+    if output_base_path.parent and str(output_base_path.parent) != '.':
+        output_base_path.parent.mkdir(parents=True, exist_ok=True)
+
+    saved_paths = []
+    for idx, image in enumerate(images):
+        image_url = extract_image_url(image)
+        if not image_url:
+            raise SystemExit("Image payload missing image_url.url.")
+        mime, raw = parse_data_url(image_url)
+        output_path = resolve_output_path(args.filename, idx, len(images), mime)
+        output_path.write_bytes(raw)
+        saved_paths.append(output_path.resolve())
+
+    for path in saved_paths:
+        print(f"Saved image to: {path}")
+        print(f"MEDIA: {path}")
+
+
+if __name__ == "__main__":
+    main()

package/skills/napkin/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

package/skills/napkin/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: napkin
+description: 'Visual whiteboard collaboration for Copilot CLI. Creates an interactive whiteboard that opens in your browser — draw, sketch, add sticky notes, then share everything back with Copilot. Copilot sees your drawings and text, and responds with analysis, suggestions, and ideas.'
+---
+
+# Napkin — Visual Whiteboard for Copilot CLI
+
+Napkin gives users a browser-based whiteboard where they can draw, sketch, and add sticky notes to think through ideas visually. The agent reads back the whiteboard contents (via a PNG snapshot and optional JSON data) and responds conversationally with analysis, suggestions, and next steps.
+
+The target audience is lawyers, PMs, and business stakeholders — not software developers. Keep everything approachable and jargon-free.
+
+---
+
+## Activation
+
+When the user invokes this skill — saying things like "let's napkin," "open a napkin," "start a whiteboard," or using the slash command — do the following:
+
+1. **Copy the bundled HTML template** from the skill assets to the user's Desktop.
+   - The template lives at `assets/napkin.html` relative to this SKILL.md file.
+   - Copy it to `~/Desktop/napkin.html`.
+   - If `~/Desktop/napkin.html` already exists, ask the user whether they want to open the existing one or start fresh before overwriting.
+
+2. **Open it in the default browser:**
+   - macOS: `open ~/Desktop/napkin.html`
+   - Linux: `xdg-open ~/Desktop/napkin.html`
+   - Windows: `start ~/Desktop/napkin.html`
+
+3. **Tell the user what to do next.** Say something warm and simple:
+
+   ```
+   Your napkin is open in your browser!
+
+   Draw, sketch, or add sticky notes — whatever helps you think through your idea.
+
+   When you're ready for my input, click the green "Share with Copilot" button on the whiteboard, then come back here and say "check the napkin."
+   ```
+
+---
+
+## Reading the Napkin
+
+When the user says "check the napkin," "look at the napkin," "what do you think," "read my napkin," or anything similar, follow these steps:
+
+### Step 1 — Read the PNG snapshot (primary)
+
+Look for a PNG file called `napkin-snapshot.png`. Check these locations in order (the browser saves it to the user's default download folder, which varies):
+
+1. `~/Downloads/napkin-snapshot.png`
+2. `~/Desktop/napkin-snapshot.png`
+
+Use the `view` tool to read the PNG. This sends the image as base64-encoded data to the model, which can visually interpret it. The PNG is the **primary** way the agent understands what the user drew — it captures freehand sketches, arrows, spatial layout, annotations, circled or crossed-out items, and anything else on the canvas.
+
+If the PNG is not found in either location, do NOT silently skip it. Instead, tell the user:
+
+```
+I don't see a snapshot from your napkin yet. Here's what to do:
+
+1. Go to your whiteboard in the browser
+2. Click the green "Share with Copilot" button
+3. Come back here and say "check the napkin" again
+
+The button saves a screenshot that I can look at.
+```
+
+### Step 2 — Read the clipboard for structured JSON (supplementary)
+
+Also try to grab structured JSON data from the system clipboard. The whiteboard copies this automatically alongside the PNG.
+
+- macOS: `pbpaste`
+- Linux: `xclip -selection clipboard -o`
+- Windows: `powershell -command "Get-Clipboard"`
+
+The JSON contains the exact text content of sticky notes and text labels, their positions, and their colors. This supplements the PNG by giving you precise text that might be hard to read from a screenshot.
+
+If the clipboard doesn't contain JSON data, that's fine — the PNG alone gives the model plenty to work with. Do not treat a missing clipboard as an error.
+
+### Step 3 — Interpret both sources together
+
+Synthesize the visual snapshot and the structured text into a coherent understanding of what the user is thinking or planning:
+
+- **From the PNG:** Describe what you see — sketches, diagrams, flowcharts, groupings, arrows, spatial layout, annotations, circled items, crossed-out items, emphasis marks.
+- **From the JSON:** Read the exact text content of sticky notes and labels, noting their positions and colors.
+- **Combine both** into a single, conversational interpretation.
+
+### Step 4 — Respond conversationally
+
+Do not dump raw data or a technical summary. Respond as a collaborator who looked at someone's whiteboard sketch. Examples:
+
+- "I can see you've sketched out a three-stage process — it looks like you're thinking about [X] flowing into [Y] and then [Z]. The sticky note in the corner says '[text]' — is that a concern you want me to address?"
+- "It looks like you've grouped these four ideas together on the left side and separated them from the two items on the right. Are you thinking of these as two different categories?"
+- "I see you drew arrows connecting [A] to [B] to [C] — is this the workflow you're envisioning?"
+
+### Step 5 — Ask what's next
+
+Always end by offering a next step:
+
+- "Want me to build on this?"
+- "Should I turn this into a structured document?"
+- "Want me to add my suggestions to the napkin?"
+
+---
+
+## Responding on the Napkin
+
+When the user wants the agent to add content back to the whiteboard:
+
+- The agent **cannot** directly modify the HTML file's canvas state — that's managed by JavaScript running in the browser.
+- Instead, offer practical alternatives:
+  - Provide the response right here in the CLI, and suggest the user add it to the napkin manually.
+  - Offer to create a separate document (markdown, memo, checklist, etc.) based on what was interpreted from the napkin.
+  - If it makes sense, create an updated copy of `napkin.html` with pre-loaded content.
+
+---
+
+## Tone and Style
+
+- Use the same approachable, non-technical tone as the noob-mode skill.
+- Never use developer jargon without explaining it in plain English.
+- Treat the napkin as a creative, collaborative space — not a formal input mechanism.
+- Be encouraging about the user's sketches regardless of artistic quality.
+- Frame responses as "building on your thinking," not "analyzing your input."
+
+---
+
+## Error Handling
+
+**PNG snapshot not found:**
+
+```
+I don't see a snapshot from your napkin yet. Here's what to do:
+
+1. Go to your whiteboard in the browser
+2. Click the green "Share with Copilot" button
+3. Come back here and say "check the napkin" again
+
+The button saves a screenshot that I can look at.
+```
+
+**Whiteboard file doesn't exist on Desktop:**
+
+```
+It looks like we haven't started a napkin yet. Want me to open one for you?
+```
+
+---
+
+## Important Notes
+
+- The PNG interpretation is the **primary** channel. Multimodal models can read and interpret the base64 image data returned by the `view` tool.
+- The JSON clipboard data is **supplementary** — it provides precise text but does not capture freehand drawings.
+- Always check for the PNG first. If it isn't found, prompt the user to click "Share with Copilot."
+- If the clipboard doesn't have JSON data, proceed with the PNG alone.
+- The HTML template is located at `assets/napkin.html` relative to this SKILL.md file.
+- If the noob-mode skill is also active, use its risk indicator format (green/yellow/red) when requesting file or bash permissions.

package/skills/napkin/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/napkin`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24