OPC Skills

repository·main·Indexed 22 days ago

https://github.com/resciencelab/opc-skills

A collection of automation skills for AI agents (such as Claude Code, Cursor, and Windsurf) designed for solopreneurs and indie hackers. Following the Agent Skills standard, it includes specialized tools for SEO/GEO optimization, market research via Reddit, X, and Product Hunt, asset creation with AI logos and banners, and session archiving. Installation is supported across 16+ AI tools using the `npx skills add` command.

Tokens
47.2K
Snippets
139
Records
230
Agent score
78%

What's inside opc-skills

  1. Use the Reddit Skill to retrieve content

    main

    The Reddit Skill allows you to search and retrieve posts, comments, subreddit information, and user profiles using Reddit's public JSON API. It requires no API key for authentication.

    Prerequisites:

    • No API key required.
    • To verify installation, run a quick check from the skill directory:
    cd <skill_directory>
    python3 scripts/get_posts.py python --limit 3
  2. Use the domain-hunter skill

    main

    The domain-hunter skill helps users find and purchase domain names at the best price. It automates the process of generating domain ideas, checking availability, comparing registrar prices, and finding promo codes. Use this skill when a user wants to buy a domain, check domain prices, find domain deals, compare registrars, or search for .ai or .com domains.

    name: domain-hunter
    description: Search domains, compare prices, find promo codes, get purchase recommendations. Use when user wants to buy a domain, check domain prices, find domain deals, compare registrars, or search for .ai/.com domains.
  3. What is an Agent Skill and how is it structured?

    main

    An Agent Skill is a structured Markdown file (SKILL.md) designed to be executed by AI agents rather than just read by humans. It transforms descriptive documentation into imperative instructions that an AI can follow to complete tasks.

    A skill consists of four essential components:

    1. YAML Frontmatter: Metadata for discovery (name, description, triggers, dependencies).
    2. Instructions: Clear, imperative commands (e.g., "When user asks for X, do Y").
    3. Examples: Concrete workflows showing the expected input and action.
    4. Scripts (optional): Automation helpers like Python or Bash scripts.

    To be effective, skills should avoid being vague, include specific triggers (keywords or error messages), and declare any dependencies on other skills.

    ---
    name: your-skill-name
    description: What this skill does in one sentence
    triggers:
      - keyword that activates this skill
      - another trigger phrase
    dependencies:
      - other-skill-if-needed
    ---
    
    # Your Skill Title
    
    Instructions that AI can follow step-by-step...
  4. What is Ralph and how does the autonomous loop work?

    main

    Ralph is an autonomous AI agent loop (implemented as a bash script) that automates the process of turning a Product Requirements Document (PRD) into working features.

    Unlike traditional AI coding assistants that suffer from context window degradation, Ralph uses a fresh AI instance for every iteration. It maintains state and memory through persistent artifacts rather than a single long-running context window. This ensures high code quality remains consistent throughout the entire development cycle.

    Core Memory Artifacts

    • prd.json: A task list containing user stories and their completion status (passes: true/false).
    • progress.txt: An append-only file used to capture learnings, technical hurdles, and patterns discovered during development.
    • Git history: Provides context on previous code changes, commits, and diffs.
    • AGENTS.md: Stores discovered project conventions and best practices.

    The 10-Step Autonomous Cycle

    1. Create a feature branch based on the branchName field in the PRD.
    2. Load artifacts (progress.txt, prd.json, git diff) into a fresh AI instance.
    3. The AI selects the highest priority story where passes is false.
    4. The AI implements that specific story.
    5. The AI runs quality checks (typechecking, linting, unit/integration tests).
    6. If checks pass, the AI commits the changes with a descriptive message.
    7. The AI updates prd.json to mark the story as passes: true.
    8. The AI appends learnings to progress.txt and updates AGENTS.md.
    9. The loop repeats until all stories pass or the maximum iteration limit is reached.
    10. The process exits with an <promise>COMPLETE</promise> output.
    {
      "projectName": "SaaS Dashboard MVP",
      "branchName": "feature/user-dashboard",
      "userStories": [
        { "id": "story-1", "title": "Supabase auth setup", "passes": false },
        { "id": "story-2", "title": "Login/signup forms", "passes": false }
      ]
    }
  5. What is Generative Engine Optimization (GEO)?

    main

    Generative Engine Optimization (GEO) is a framework designed to improve content visibility within generative engine responses (AI search engines like ChatGPT, Perplexity, and Google SGE).

    Unlike traditional SEO, which focuses on ranking in search engine results pages (SERPs), GEO focuses on being cited by AI systems. Research indicates that implementing GEO methods can provide a visibility boost of up to 40%, and low-ranking sites can see boosts of up to 115% when using citations.

  6. How Ralph and OPC Skills work together

    main

    Ralph is an autonomous AI agent loop that uses coding tools (like Amp CLI or Claude Code) to implement features defined in a prd.json file.

    When combined with OPC Skills, Ralph can perform complex, multi-stage workflows. Because OPC Skills are installed globally, Ralph's AI instances can invoke them during the development loop. For example, a PRD can explicitly instruct Ralph to:

    • "Use domain-hunter to find available .io domains"
    • "Use logo-creator to generate app logo"
    • "Use seo-geo to add meta tags and generate sitemaps"

    This allows for a complete automation flow from market research and design to feature development and SEO optimization.

  7. Optimize for GEO (Generative Engine Optimization) using Princeton Methods

    main

    To increase visibility in AI-generated responses (GEO), apply the following content strategies:

    1. Add Statistics: Use specific, quantifiable metrics (e.g., "10+ Skills | 5 Platforms") to make content easily extractable and quotable by AI.
    2. Implement FAQ Sections: Add a dedicated FAQ section with an Answer-First structure. Each answer should start with a direct response to the question to match AI response patterns.
    3. Use Authoritative Tone: Use definitive language (e.g., "The definitive skill library...") and include Citations to authoritative sources (e.g., official documentation or industry leaders).
    4. Keyword Strategy: Avoid high-competition generic terms in favor of long-tail keywords that define your specific niche (e.g., instead of "AI tools", use "Claude Code skills").
  8. Requirements for Ralph: Automated Quality Checks

    main

    For Ralph's autonomous loop to function effectively and self-correct, the project must have automated quality checks in place. Ralph relies on these checks to determine if a user story has successfully passed. If a check fails, the story remains marked as passes: false in prd.json and is retried in the next iteration.

    Critical checks include:

    • Type checking: e.g., TypeScript, mypy to catch type errors.
    • Unit tests: e.g., Jest, pytest to verify logic.
    • Integration tests: e.g., Playwright, Cypress to confirm end-to-end workflows.
    • CI/CD pipelines: Ensuring the environment remains stable.
  9. Core features of the SEO-GEO skill

    main

    The SEO-GEO skill provides five primary capabilities for optimizing content for Generative Engine Optimization (GEO):

    1. Website SEO Audit: Analyzes URLs for meta tags, Schema.org, robots.txt, and AI bot access.
    2. GEO Optimization Analysis: Evaluates content against the 9 Princeton GEO methods (e.g., checking for citations, statistics, expert quotes, and FAQ sections).
    3. Schema.org Generator: Automatically generates JSON-LD structured data for BlogPosting, HowTo, FAQPage, Product, and Organization.
    4. AI Bot Access Checker: Verifies that robots.txt explicitly allows key AI crawlers like GPTBot, PerplexityBot, and ClaudeBot.
    5. Keyword Research for AI: Identifies answer-focused keywords prioritized by AI search engines rather than traditional commercial intent keywords.
  10. Handle Async Operations

    main

    Critical actions like domain registration and transfers are processed asynchronously. When you initiate these actions, the API returns a spaceship-async-operationid in the response header.

    To check if the task is finished, poll the following endpoint: GET /v1/async-operations/{operationId}

    Possible Statuses:

    • pending
    • success
    • failed
    # Poll for operation status
    curl -s -X GET "https://spaceship.dev/api/v1/async-operations/{operationId}" \
      -H "X-Api-Key: $SPACESHIP_API_KEY" \
      -H "X-Api-Secret: $SPACESHIP_API_SECRET"
  11. Optimize for GEO (AI Search Visibility)

    main

    To increase visibility in AI-driven search engines (GEO), implement the following strategies:

    Content Structure for AI

    • Use an "Answer-first" format (place the direct answer at the top).
    • Provide clear, extractable paragraphs.
    • Use FAQ formats for common questions.
    • Use Tables for comparison data and Lists for step-by-step processes.

    Princeton GEO Methods (High Impact)

    • Include authoritative citations (+40% impact).
    • Include statistics and data points (+37% impact).
    • Include expert quotes with attribution (+30% impact).
    • Avoid keyword stuffing (causes -10% impact).
    • Maintain an authoritative, confident tone.
    • Ensure content is accessible and easy to understand.
    • Use appropriate technical terminology and diverse vocabulary.
    • Maintain high fluency and readability.

    AI Bot Access

    Ensure your robots.txt allows the following bots:

    • GPTBot
    • PerplexityBot
    • ClaudeBot
    • Anthropic-ai
    • Bingbot
  12. What are Agent Skills?

    main

    Agent skills are structured markdown files designed to be consumed by both humans and AI coding assistants (such as Claude Code, Cursor, and Windsurf). Unlike traditional documentation, skills are actionable: they provide the AI agent with the instructions, triggers, and tools necessary to execute specific tasks automatically.

    A skill typically consists of:

    • YAML frontmatter: Metadata including name, description, triggers, and dependencies.
    • Structured instructions: Step-by-step guidance for the AI.
    • Scripts and tools: Automation components for execution.
    • Examples: Real-world usage patterns.
    ---
    name: domain-hunter
    description: Search domains, compare registrar prices, find promo codes
    triggers:
      - domain
      - registrar
      - buy domain
    dependencies:
      - twitter
      - reddit
    ---