undefined

undefined

undefined

undefined

undefined

undefined

python skill-installer/scripts/install-skill-from-github.py [OPTIONS]

undefined

undefined

import subprocess
import os

def install_meeting_notes_skill():
    """Install the meeting-notes-and-actions skill."""
    repo = "ComposioHQ/awesome-codex-skills"
    path = "meeting-notes-and-actions"
    
    cmd = [
        "python",
        "skill-installer/scripts/install-skill-from-github.py",
        "--repo", repo,
        "--path", path
    ]
    
    result = subprocess.run(cmd, capture_output=True, text=True)
    
    if result.returncode == 0:
        print(f"✓ Skill installed to {os.environ.get('CODEX_HOME', '~/.codex')}/skills/{path}")
        print("Restart Codex to load the skill.")
    else:
        print(f"✗ Installation failed: {result.stderr}")
    
    return result.returncode == 0

undefined

import subprocess
from typing import List, Tuple

def batch_install_skills(skills: List[Tuple[str, str]]):
    """
    Install multiple skills from the awesome-codex-skills collection.
    
    Args:
        skills: List of (repo, path) tuples
    """
    results = []
    
    for repo, path in skills:
        print(f"Installing {path} from {repo}...")
        
        cmd = [
            "python",
            "skill-installer/scripts/install-skill-from-github.py",
            "--repo", repo,
            "--path", path
        ]
        
        result = subprocess.run(cmd, capture_output=True, text=True)
        success = result.returncode == 0
        
        results.append({
            "skill": path,
            "success": success,
            "output": result.stdout if success else result.stderr
        })
        
        status = "✓" if success else "✗"
        print(f"{status} {path}")
    
    return results

undefined

undefined

undefined

import os
from pathlib import Path

def list_installed_skills():
    """List all installed Codex skills with their metadata."""
    codex_home = os.environ.get("CODEX_HOME", os.path.expanduser("~/.codex"))
    skills_dir = Path(codex_home) / "skills"
    
    if not skills_dir.exists():
        print(f"Skills directory not found: {skills_dir}")
        return []
    
    skills = []
    for skill_path in skills_dir.iterdir():
        if not skill_path.is_dir() or skill_path.name.startswith("."):
            continue
        
        skill_md = skill_path / "SKILL.md"
        if not skill_md.exists():
            continue
        
        # Parse frontmatter for name and description
        with open(skill_md, "r") as f:
            content = f.read()
            if content.startswith("---"):
                frontmatter = content.split("---")[1]
                name = None
                description = None
                
                for line in frontmatter.split("\n"):
                    if line.startswith("name:"):
                        name = line.split(":", 1)[1].strip()
                    elif line.startswith("description:"):
                        description = line.split(":", 1)[1].strip()
                
                skills.append({
                    "path": skill_path.name,
                    "name": name,
                    "description": description
                })
    
    return skills

undefined

def install_category(category: str):
    """Install all skills from a specific category."""
    
    categories = {
        "dev-tools": [
            "codebase-migrate",
            "gh-fix-ci",
            "sentry-triage",
            "webapp-testing"
        ],
        "productivity": [
            "meeting-notes-and-actions",
            "issue-triage",
            "notion-knowledge-capture",
            "support-ticket-triage"
        ],
        "writing": [
            "email-draft-polish",
            "changelog-generator",
            "content-research-writer"
        ]
    }
    
    if category not in categories:
        print(f"Unknown category: {category}")
        return
    
    skills = [(f"ComposioHQ/awesome-codex-skills", path) 
              for path in categories[category]]
    
    return batch_install_skills(skills)

undefined

undefined

undefined

undefined

undefined

skill-name/
├── SKILL.md          # Main skill definition
├── examples/         # Optional: example files
├── templates/        # Optional: templates
└── README.md         # Optional: additional docs

---
name: skill-name
description: One-line description of what the skill does
triggers:
  - "phrase users might say"
  - "another natural trigger"
  - "install X"
---

undefined

undefined

undefined

undefined

for name, cmd in checks.items():
    try:
        result = subprocess.run(cmd, capture_output=True, text=True)
        if result.returncode == 0:
            print(f"✓ {name}: {result.stdout.strip()}")
        else:
            print(f"✗ {name}: not working")
    except FileNotFoundError:
        print(f"✗ {name}: not found")

undefined

undefined

undefined

undefined

undefined

---
name: my-awesome-skill
description: Does something specific and useful
triggers:
  - "do the thing"
  - "help me with X"
---

undefined

undefined

undefined

undefined

undefined