explaingit

961882/ray-skills

Analysis updated 2026-05-18

25Audience · pm founderComplexity · 2/5Setup · easy

TLDR

A set of three AI agent skills for content topic planning, simulated multi-role discussions, and creating new discussion roles, built for tools like Claude Code and Cursor.

Mindmap

mindmap
  root((repo))
    What it does
      Content topic planning
      Multi party role simulation
      Custom role creation
    Tech stack
      AI Skill
      YAML
    Use cases
      Plan article topics
      Simulate team discussions
      Create new personas
    Audience
      Content creators
      Product teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a source document into a full content plan with topic ideas, titles, and outlines.

USE CASE 2

Simulate a roundtable or debate between roles like product manager, architect, and QA on a decision.

USE CASE 3

Create a new discussion persona, such as legal or finance, in the format the discussion skill expects.

USE CASE 4

Calibrate generated content ideas against an author's past articles to match their voice.

What is it built with?

AI SkillYAML

How does it compare?

961882/ray-skills0xpira/sskillsadisbladis/nix-cache-beacon
Stars252525
LanguageJavaScriptGo
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencepm founderdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Copy the full skill folder, not just SKILL.md, into your AI tool's skills directory and restart it.

In plain English

Ray Skills is a collection of three AI agent skills primarily aimed at Chinese-language content creators and product teams. The skills are designed to work with AI coding tools that support the skill or custom instruction format, including Codex, Claude Code, and Cursor. Each skill is a structured folder of workflow and reference files that an AI agent can follow step by step. The first skill, ray-content-topic-planning, takes a source document such as a whitepaper, long-form article, or interview transcript and produces a full content publishing plan from it. Given the source material and a description of the author's identity, target audience, and writing style, the skill generates around 20 candidate topic ideas, narrows them to five selected directions, produces title options and article outlines for each, and assigns scores. If historical articles are provided, it also uses them to calibrate what fits the author's established voice. The second skill, ray-multi-party-mode, simulates a structured discussion between multiple professional personas on a given question or decision. You can choose roles such as product manager, architect, QA, growth lead, or operations, and pick a discussion format: roundtable, debate, critique, planning breakdown, or decision convergence. The skill can run with one agent simulating all roles quickly, or with separate sub-agents for each role when a more independent analysis per perspective is wanted. The third skill, ray-role-creator, is a companion to the multi-party discussion skill. It creates new role definitions, such as legal, finance, sales, or recruiting personas, and outputs them in a YAML format that can be pasted directly into the role library used by the discussion skill. It checks for overlap with existing roles before creating new ones. Installation for each tool follows its own convention: copying the full skill folder into a specific local directory and restarting the AI tool. Only copying the single SKILL.md file is not enough because each skill depends on adjacent workflow and reference files.

Copy-paste prompts

Prompt 1
Use ray-content-topic-planning to turn this document into 20 candidate article topics.
Prompt 2
Run ray-multi-party-mode as a roundtable between product manager, architect, and QA on this decision.
Prompt 3
Use ray-role-creator to add a new finance persona to the discussion role library.
Prompt 4
Generate five title options and an outline for the top-scoring topic idea from this document.

Frequently asked questions

What is ray-skills?

A set of three AI agent skills for content topic planning, simulated multi-role discussions, and creating new discussion roles, built for tools like Claude Code and Cursor.

How hard is ray-skills to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ray-skills for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.