opencode-skills-collection 3.0.37 → 3.0.38

package/bundled-skills/2slides-ppt-generator/scripts/generate_slides.py

@@ -0,0 +1,247 @@
+#!/usr/bin/env python3
+"""
+Generate slides using the 2slides API.
+Supports both content-based and reference image-based generation.
+"""
+
+import os
+import sys
+import json
+import time
+import argparse
+import requests
+from typing import Optional, Dict, Any
+
+
+API_BASE_URL = "https://2slides.com/api/v1"
+
+
+def get_api_key() -> str:
+    """Get API key from environment variable."""
+    api_key = os.environ.get("SLIDES_2SLIDES_API_KEY")
+    if not api_key:
+        raise ValueError(
+            "API key not found. Set SLIDES_2SLIDES_API_KEY environment variable.\n"
+            "Get your API key from: https://2slides.com/api"
+        )
+    return api_key
+
+
+def generate_slides(
+    user_input: str,
+    theme_id: str,
+    response_language: str = "Auto",
+    mode: str = "sync",
+    api_key: Optional[str] = None
+) -> Dict[str, Any]:
+    """
+    Generate slides from user input.
+
+    Args:
+        user_input: Content to convert into slides
+        theme_id: Theme ID (required, use search_themes.py to find themes)
+        response_language: Language (default: "Auto")
+            Options: Auto, English, Simplified Chinese, Traditional Chinese, Spanish,
+            Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German,
+            Vietnamese, Turkish, Polish, Italian, Korean
+        mode: "sync" or "async" (default: "sync")
+        api_key: API key (uses env var if not provided)
+
+    Returns:
+        Dict with generation result or job ID
+    """
+    if api_key is None:
+        api_key = get_api_key()
+
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json"
+    }
+
+    payload = {
+        "userInput": user_input,
+        "themeId": theme_id,
+        "responseLanguage": response_language,
+        "mode": mode
+    }
+
+    url = f"{API_BASE_URL}/slides/generate"
+
+    # Set timeout: 90s for sync (waits for completion), 30s for async (just creates job)
+    timeout = 90 if mode == "sync" else 30
+
+    print(f"Generating slides in {mode} mode...", file=sys.stderr)
+    response = requests.post(url, headers=headers, json=payload, timeout=timeout)
+    response.raise_for_status()
+
+    result = response.json()
+
+    # Check API response structure
+    if not result.get("success"):
+        error_msg = result.get("error", "Unknown error")
+        raise ValueError(f"API error: {error_msg}")
+
+    # Extract data from response
+    data = result.get("data")
+    if not data:
+        raise ValueError("No data in API response")
+
+    if mode == "sync":
+        print("✓ Slides generated successfully!", file=sys.stderr)
+        print(f"  Pages: {data.get('slidePageCount', 'N/A')}", file=sys.stderr)
+        if data.get("downloadUrl"):
+            print(f"  Download URL: {data.get('downloadUrl')}", file=sys.stderr)
+    else:
+        print(f"✓ Job created: {data.get('jobId')}", file=sys.stderr)
+        print("Use get_job_status.py to check status", file=sys.stderr)
+
+    return data
+
+
+def create_like_this(
+    user_input: str,
+    reference_image_url: str,
+    response_language: str = "Auto",
+    aspect_ratio: str = "16:9",
+    resolution: str = "2K",
+    page: int = 1,
+    content_detail: str = "concise",
+    api_key: Optional[str] = None
+) -> Dict[str, Any]:
+    """
+    Generate slides matching a reference image style (Nano Banana Pro).
+
+    Args:
+        user_input: Content to convert into slides
+        reference_image_url: URL or base64 of reference image to match style
+        response_language: Language (default: "Auto")
+            Options: Auto, English, Simplified Chinese, Traditional Chinese, Spanish,
+            Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German,
+            Vietnamese, Turkish, Polish, Italian, Korean
+        aspect_ratio: Aspect ratio in width:height format (default: "16:9")
+        resolution: Output quality - "1K", "2K", or "4K" (default: "2K")
+        page: Number of slides, 0 for auto-detection, max 100 (default: 1)
+        content_detail: "concise" (brief, keyword-focused) or "standard" (comprehensive) (default: "concise")
+        api_key: API key (uses env var if not provided)
+
+    Returns:
+        Dict with generation result
+    """
+    if api_key is None:
+        api_key = get_api_key()
+
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json"
+    }
+
+    payload = {
+        "userInput": user_input,
+        "referenceImageUrl": reference_image_url,
+        "responseLanguage": response_language,
+        "aspectRatio": aspect_ratio,
+        "resolution": resolution,
+        "page": page,
+        "contentDetail": content_detail
+    }
+
+    url = f"{API_BASE_URL}/slides/create-like-this"
+
+    # Calculate dynamic timeout: ~30s per page, minimum 120s
+    timeout = max(120, page * 40)
+
+    print("Generating slides from reference image...", file=sys.stderr)
+    print(f"(Timeout set to {timeout}s for {page} page(s))", file=sys.stderr)
+    response = requests.post(url, headers=headers, json=payload, timeout=timeout)
+    response.raise_for_status()
+
+    result = response.json()
+
+    # Handle the actual API response structure
+    if result.get("success") and "data" in result:
+        data = result["data"]
+        # Transform to expected format for consistency
+        normalized_result = {
+            "slideUrl": data.get("jobUrl"),
+            "pdfUrl": data.get("downloadUrl"),
+            "status": "completed" if data.get("status") == "success" else data.get("status"),
+            "message": data.get("message"),
+            "slidePageCount": data.get("slidePageCount"),
+            "jobId": data.get("jobId")
+        }
+        print("✓ Slides generated successfully!", file=sys.stderr)
+        print(f"  Pages: {data.get('slidePageCount')}", file=sys.stderr)
+        return normalized_result
+    else:
+        # Fallback to raw result if structure is unexpected
+        print("✓ Request completed!", file=sys.stderr)
+        return result
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Generate slides using 2slides API",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Generate slides from content
+  %(prog)s --content "Intro to AI: ML, Deep Learning, Neural Networks"
+
+  # Generate with specific theme
+  %(prog)s --content "Business Plan" --theme-id "theme123"
+
+  # Generate in async mode
+  %(prog)s --content "Long presentation" --mode async
+
+  # Generate from reference image
+  %(prog)s --content "Sales Report" --reference-image "https://example.com/image.jpg"
+        """
+    )
+
+    parser.add_argument("--content", required=True, help="Content for slides")
+    parser.add_argument("--theme-id", help="Theme ID (required for standard generation)")
+    parser.add_argument("--reference-image", help="Reference image URL (use this OR theme-id)")
+    parser.add_argument("--language", default="Auto", help="Response language (default: Auto)")
+    parser.add_argument("--mode", choices=["sync", "async"], default="sync",
+                       help="Generation mode (default: sync)")
+    parser.add_argument("--aspect-ratio", default="16:9", help="Aspect ratio in width:height format (default: 16:9)")
+    parser.add_argument("--resolution", choices=["1K", "2K", "4K"], default="2K",
+                       help="Output quality (default: 2K)")
+    parser.add_argument("--page", type=int, default=1, help="Number of slides, 0 for auto (default: 1, max: 100)")
+    parser.add_argument("--content-detail", choices=["concise", "standard"], default="concise",
+                       help="Content detail level (default: concise)")
+
+    args = parser.parse_args()
+
+    try:
+        if args.reference_image:
+            result = create_like_this(
+                user_input=args.content,
+                reference_image_url=args.reference_image,
+                response_language=args.language,
+                aspect_ratio=args.aspect_ratio,
+                resolution=args.resolution,
+                page=args.page,
+                content_detail=args.content_detail
+            )
+        else:
+            if not args.theme_id:
+                print("Error: --theme-id is required for standard generation", file=sys.stderr)
+                print("Use --reference-image for style-based generation instead", file=sys.stderr)
+                sys.exit(1)
+            result = generate_slides(
+                user_input=args.content,
+                theme_id=args.theme_id,
+                response_language=args.language,
+                mode=args.mode
+            )
+
+        print(json.dumps(result, indent=2))
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/2slides-ppt-generator/scripts/get_job_status.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""
+Check the status of an async slide generation job.
+"""
+
+import os
+import sys
+import json
+import argparse
+import requests
+from typing import Optional, Dict, Any
+
+
+API_BASE_URL = "https://2slides.com/api/v1"
+
+
+def get_api_key() -> str:
+    """Get API key from environment variable."""
+    api_key = os.environ.get("SLIDES_2SLIDES_API_KEY")
+    if not api_key:
+        raise ValueError(
+            "API key not found. Set SLIDES_2SLIDES_API_KEY environment variable.\n"
+            "Get your API key from: https://2slides.com/api"
+        )
+    return api_key
+
+
+def get_job_status(
+    job_id: str,
+    api_key: Optional[str] = None
+) -> Dict[str, Any]:
+    """
+    Get the status of a slide generation job.
+
+    Args:
+        job_id: Job ID from async generation
+        api_key: API key (uses env var if not provided)
+
+    Returns:
+        Dict with job status and result
+    """
+    if api_key is None:
+        api_key = get_api_key()
+
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json"
+    }
+
+    url = f"{API_BASE_URL}/jobs/{job_id}"
+
+    print(f"Checking job status: {job_id}...", file=sys.stderr)
+    response = requests.get(url, headers=headers)
+    response.raise_for_status()
+
+    result = response.json()
+
+    # Check API response structure
+    if not result.get("success"):
+        error_msg = result.get("error", "Unknown error")
+        raise ValueError(f"API error: {error_msg}")
+
+    # Extract data from response
+    data = result.get("data")
+    if not data:
+        raise ValueError("No data in API response")
+
+    status = data.get("status", "unknown")
+
+    print(f"✓ Job status: {status}", file=sys.stderr)
+    if data.get("message"):
+        print(f"  Message: {data.get('message')}", file=sys.stderr)
+    if data.get("slidePageCount"):
+        print(f"  Pages: {data.get('slidePageCount')}", file=sys.stderr)
+    if data.get("downloadUrl"):
+        print(f"  Download URL: {data.get('downloadUrl')}", file=sys.stderr)
+
+    return data
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Check 2slides job status",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Check job status
+  %(prog)s --job-id abc123
+        """
+    )
+
+    parser.add_argument("--job-id", required=True, help="Job ID to check")
+
+    args = parser.parse_args()
+
+    try:
+        result = get_job_status(job_id=args.job_id)
+        print(json.dumps(result, indent=2))
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/2slides-ppt-generator/scripts/search_themes.py

@@ -0,0 +1,137 @@
+#!/usr/bin/env python3
+"""
+Search for available themes in the 2slides catalog.
+"""
+
+import os
+import sys
+import json
+import argparse
+import requests
+from typing import Optional, List, Dict, Any
+
+
+API_BASE_URL = "https://2slides.com/api/v1"
+
+
+def get_api_key() -> str:
+    """Get API key from environment variable."""
+    api_key = os.environ.get("SLIDES_2SLIDES_API_KEY")
+    if not api_key:
+        raise ValueError(
+            "API key not found. Set SLIDES_2SLIDES_API_KEY environment variable.\n"
+            "Get your API key from: https://2slides.com/api"
+        )
+    return api_key
+
+
+def search_themes(
+    query: str,
+    limit: int = 20,
+    api_key: Optional[str] = None
+) -> List[Dict[str, Any]]:
+    """
+    Search for themes.
+
+    Args:
+        query: Search query (required keyword)
+        limit: Maximum number of results (max 100, default 20)
+        api_key: API key (uses env var if not provided)
+
+    Returns:
+        List of theme objects
+    """
+    if api_key is None:
+        api_key = get_api_key()
+
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json"
+    }
+
+    params = {
+        "query": query,
+        "limit": min(limit, 100)
+    }
+
+    url = f"{API_BASE_URL}/themes/search"
+
+    print(f"Searching themes{f': {query}' if query else ''}...", file=sys.stderr)
+    response = requests.get(url, headers=headers, params=params)
+    response.raise_for_status()
+
+    result = response.json()
+
+    # Check API response structure
+    if not result.get("success"):
+        error_msg = result.get("error", "Unknown error")
+        raise ValueError(f"API error: {error_msg}")
+
+    # Extract data from response
+    data = result.get("data")
+    if not data:
+        raise ValueError("No data in API response")
+
+    themes = data.get("themes", [])
+
+    print(f"✓ Found {len(themes)} theme(s)", file=sys.stderr)
+
+    return themes
+
+
+def format_theme(theme: Dict[str, Any]) -> str:
+    """Format a theme object for display."""
+    theme_id = theme.get("id", "N/A")
+    name = theme.get("name", "Unnamed")
+    description = theme.get("description", "No description")
+
+    return f"ID: {theme_id}\nName: {name}\nDescription: {description}\n"
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Search for 2slides themes",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Search for business themes
+  %(prog)s --query "business"
+
+  # Search for creative themes
+  %(prog)s --query "creative"
+
+  # Get more results
+  %(prog)s --query "professional" --limit 50
+        """
+    )
+
+    parser.add_argument("--query", required=True, help="Search query (required keyword)")
+    parser.add_argument("--limit", type=int, default=20,
+                       help="Maximum results (max 100, default 20)")
+    parser.add_argument("--json", action="store_true",
+                       help="Output raw JSON")
+
+    args = parser.parse_args()
+
+    try:
+        themes = search_themes(
+            query=args.query,
+            limit=args.limit
+        )
+
+        if args.json:
+            print(json.dumps(themes, indent=2))
+        else:
+            print()
+            for i, theme in enumerate(themes, 1):
+                print(f"Theme {i}:")
+                print(format_theme(theme))
+                print("-" * 60)
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/anti-sycophancy/README.md

@@ -0,0 +1,86 @@
+# Anti-Sycophancy
+
+A skill for OpenCode that detects and eliminates sycophantic patterns in AI responses. Sycophancy is when an AI prioritises affirming a user's stated or implied beliefs over epistemic integrity — an RLHF structural artifact, not an attitude problem.
+
+## Installation
+
+```bash
+mkdir -p ~/.config/opencode/skills
+cp -r anti-sycophancy ~/.config/opencode/skills/
+```
+
+## Usage
+
+Load the skill explicitly when you want the agent to prioritise directness:
+
+```
+/skill anti-sycophancy
+```
+
+Once loaded, the agent follows a procedural anti-sycophancy process for every response: extract the user's core claim, assess it independently, conclude based on evidence, and respond conclusion-first.
+
+You can also reference it inline:
+
+```
+With the anti-sycophancy skill active, review this architecture:
+```
+
+## Patterns Covered
+
+### Epistemic Sycophancy (what you say)
+
+| # | Pattern | What it catches |
+|---|---------|-----------------|
+| 1 | **Answer Sycophancy** | Agreeing with incorrect user claims instead of correcting them |
+| 2 | **Premise Endorsement** | Answering within a flawed frame instead of challenging it |
+| 3 | **Mimicry Sycophancy** | Adopting the user's errors and following flawed reasoning chains |
+| 4 | **Feedback Sycophancy** | Predictably biased positive evaluation when asked to review |
+
+### Soft Sycophancy (how you say it)
+
+| # | Pattern | What it catches |
+|---|---------|-----------------|
+| 5 | **Validation-Before-Correction** | Emotional preamble before disagreement (most common form) |
+| 6 | **Emotional Over-validation** | "Great question!", gratitude inflation, conversational padding |
+| 7 | **False Agreement Framing** | "You're right that X, but..." where X isn't right |
+| 8 | **Hedged Disagreement** | "You might also consider..." instead of "That won't work" |
+| 9 | **Deference Posturing** | Inflating the user's authority to avoid taking a position |
+| 10 | **Opinion Reversal on Pushback** | Changing a correct answer when challenged, without new evidence |
+
+### Social Sycophancy (who the user is)
+
+| # | Pattern | What it catches |
+|---|---------|-----------------|
+| 11 | **Status Deference** | Agreeing more readily when user signals expertise or authority |
+| 12 | **Identity Alignment** | Shifting positions toward perceived user identity |
+| 13 | **Face-Preserving Agreement** | Agreeing to avoid social friction despite evidence |
+
+## How It Works
+
+No pattern matching. A single procedural discipline applied to every response:
+
+1. **Extract** the user's core claim from their framing. State it stripped of premises.
+2. **Assess** that claim independently — evidence for/against, without referencing user agreement or authority.
+3. **Conclude** based solely on step 2.
+4. **Respond** with the conclusion first, evidence second.
+
+When the user disagrees:
+- New evidence → update position, state what changed
+- Repeated opinion → restate position with evidence
+
+## References
+
+- Sharma, M., Tong, M., Korbak, T., et al. (2023). Towards Understanding Sycophancy in Language Models. *ICLR 2024*. arXiv:2310.13548.
+- Perez, E., et al. (2022). Discovering Language Model Behaviors with Model-Written Evaluations. *ACL 2023 Findings*.
+- Dubois, M., Ududec, C., Summerfield, C., & Luettgau, L. (2026). Ask Don't Tell: Reducing Sycophancy in Large Language Models. arXiv:2602.23971.
+- Gligorić, K., et al. (2026). SWAY: A Counterfactual Computational Linguistic Approach to Measuring and Mitigating Sycophancy. arXiv:2604.02423.
+- Mohsin, M. A., et al. (2026). Pressure, What Pressure? Sycophancy Disentanglement via Reward Decomposition. arXiv:2604.05279.
+- Feng, Z., et al. (2026). Good Arguments Against the People Pleasers: How Reasoning Mitigates (Yet Masks) LLM Sycophancy. arXiv:2603.16643.
+- Cheng, M., Yu, S., Lee, C., Khadpe, P., Ibrahim, L., & Jurafsky, D. (2026). Social Sycophancy: A Broader Understanding of LLM Sycophancy. *Proc. ICLR 2026*. arXiv:2505.13995.
+- Ibrahim, L., Hafner, F. S., & Rocher, L. (2026). Training Language Models to be Warm Can Reduce Accuracy and Increase Sycophancy. *Nature*, 652, 1159–1165. DOI: 10.1038/s41586-026-10410-0.
+- Cheng, M., Lee, C., Khadpe, P., Yu, S., Han, D., & Jurafsky, D. (2026). Sycophantic AI Decreases Prosocial Intentions and Promotes Dependence. *Science*, 391(6792). DOI: 10.1126/science.aec8352.
+- "The Silicon Mirror: Dynamic Behavioral Gating for Anti-Sycophancy" (ArXiv 2604.00478, 2026).
+
+## License
+
+MIT

package/bundled-skills/anti-sycophancy/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: anti-sycophancy
+version: 2.0.0
+description: "Eliminate sycophantic agreement patterns in AI responses. Load via /skill anti-sycophancy."
+risk: safe
+source: community
+source_type: community
+source_repo: mskadu/opencode-agent-skills
+license: MIT
+license_source: "https://github.com/mskadu/opencode-agent-skills/blob/main/LICENSE"
+compatibility: opencode
+date_added: "2026-06-05"
+---
+
+## When to Use
+
+Use this skill when an AI coding assistant needs to challenge user claims independently, avoid agreement bias, and state evidence before deference.
+
+## Process
+
+For every response when this skill is active:
+
+1. **Extract** the user's core claim from their framing. State it in one sentence stripped of premises.
+2. **Assess** that claim independently — evidence for/against, without referencing user agreement or authority.
+3. **Conclude** based solely on step 2.
+4. **Respond** with the conclusion first, evidence second.
+
+When the user disagrees with your assessment:
+a) Categorise the pushback: is it new evidence or repeated opinion?
+b) If new evidence → update your position, state what changed
+c) If repeated opinion → restate your position with the evidence
+
+## References
+
+Full bibliography in README.md.
+
+## Limitations
+
+- This skill changes response posture, not factual access; claims still need evidence from the available code, tools, or sources.
+- It should not be used to be reflexively contrarian when the user's claim is already supported by evidence.