docs: introduce Skills system#173
Open
recoupableorg wants to merge 1 commit intomainfrom
Open
Conversation
|
Warning Rate limit exceeded
To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (11)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
There was a problem hiding this comment.
3 issues found across 11 files
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="skills/music-industry-research.mdx">
<violation number="1" location="skills/music-industry-research.mdx:16">
P3: Use the same endpoint prefix consistently; `/research/*` should be `/api/research/*` here.</violation>
</file>
<file name="skills.mdx">
<violation number="1" location="skills.mdx:12">
P3: This sentence claims the sidebar already lists all skills, but this PR intentionally does not add skills to navigation yet. Update the wording so it reflects the current behavior.</violation>
</file>
<file name="skills/setup-sandbox.mdx">
<violation number="1" location="skills/setup-sandbox.mdx:18">
P2: The endpoint label is incorrect for the linked docs page: `/api-reference/accounts/get` documents `GET /api/accounts/{id}`, not `GET /api/accounts`.</violation>
</file>
Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.
|
|
||
| ## Endpoints it uses | ||
|
|
||
| - [`GET /api/accounts`](/api-reference/accounts/get) |
There was a problem hiding this comment.
P2: The endpoint label is incorrect for the linked docs page: /api-reference/accounts/get documents GET /api/accounts/{id}, not GET /api/accounts.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At skills/setup-sandbox.mdx, line 18:
<comment>The endpoint label is incorrect for the linked docs page: `/api-reference/accounts/get` documents `GET /api/accounts/{id}`, not `GET /api/accounts`.</comment>
<file context>
@@ -0,0 +1,24 @@
+
+## Endpoints it uses
+
+- [`GET /api/accounts`](/api-reference/accounts/get)
+- [`GET /api/organizations`](/api-reference/organizations/list)
+- [`GET /api/artists`](/api-reference/artists/list)
</file context>
Suggested change
| - [`GET /api/accounts`](/api-reference/accounts/get) | |
| - [`GET /api/accounts/{id}`](/api-reference/accounts/get) |
|
|
||
| ## What it produces | ||
|
|
||
| A structured research output answering the user's question — usually a synthesis across multiple `/research/*` calls (e.g. profile + metrics + audience + similar artists), formatted for either the agent's continued reasoning or direct delivery to the user. |
There was a problem hiding this comment.
P3: Use the same endpoint prefix consistently; /research/* should be /api/research/* here.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At skills/music-industry-research.mdx, line 16:
<comment>Use the same endpoint prefix consistently; `/research/*` should be `/api/research/*` here.</comment>
<file context>
@@ -0,0 +1,24 @@
+
+## What it produces
+
+A structured research output answering the user's question — usually a synthesis across multiple `/research/*` calls (e.g. profile + metrics + audience + similar artists), formatted for either the agent's continued reasoning or direct delivery to the user.
+
+## Endpoints it uses
</file context>
|
|
||
| A Skill is a markdown file an agent reads to get domain-specific instructions for a task. They live in a separate repo so any agent (Claude Code, Cursor, or your own) can install them without coupling to a specific platform. | ||
|
|
||
| The sidebar lists every skill, grouped by purpose. Each docs page summarizes when the agent uses the skill, what it produces, and which API endpoints it depends on. The canonical instructions stay in the source repo on GitHub. |
There was a problem hiding this comment.
P3: This sentence claims the sidebar already lists all skills, but this PR intentionally does not add skills to navigation yet. Update the wording so it reflects the current behavior.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At skills.mdx, line 12:
<comment>This sentence claims the sidebar already lists all skills, but this PR intentionally does not add skills to navigation yet. Update the wording so it reflects the current behavior.</comment>
<file context>
@@ -0,0 +1,66 @@
+
+A Skill is a markdown file an agent reads to get domain-specific instructions for a task. They live in a separate repo so any agent (Claude Code, Cursor, or your own) can install them without coupling to a specific platform.
+
+The sidebar lists every skill, grouped by purpose. Each docs page summarizes when the agent uses the skill, what it produces, and which API endpoints it depends on. The canonical instructions stay in the source repo on GitHub.
+
+---
</file context>
Adds a new "Skills" surface to the docs — a set of markdown playbooks that teach AI agents how to do music industry work. Skills complement the API: the API tells an agent HOW to take action, Skills tell it WHEN and WHY. New pages: - skills.mdx — overview of what skills are, the structure of a SKILL.md file, and how to install via Claude Code's plugin marketplace or `git clone`. - skills/getting-started.mdx — install CLI, get API key, connect via MCP/REST. - skills/setup-sandbox.mdx — provision a sandbox for an account. - skills/artist-workspace.mdx — manage artist directories (RECOUP.md, context/, songs/, releases/). - skills/streaming-growth.mdx — grow a new artist past streaming milestones. - skills/chart-metric.mdx — query and analyze Chartmetric data. - skills/music-industry-research.mdx — analytics, people search, competitive analysis. - skills/song-writing.mdx — songwriting workflow. - skills/trend-to-song.mdx — reverse-engineer a song from a cultural moment. - skills/content-creation.mdx — compose social videos via the content endpoints. - skills/release-management.mdx — plan and track release campaigns. Each page summarizes when the agent uses the skill, what it produces, and which API endpoints it depends on. The canonical skill instructions live in github.com/recoupable/skills, where each skill is a directory with a SKILL.md root file plus optional references/, scripts/, and assets/. This PR adds content only — it does NOT add a Skills tab to the sidebar nav. That nav integration ships in the navigation restructure PR (PR 7 of the stack), which makes these pages visible alongside the existing reference docs. Made-with: Cursor
recoupableorg
force-pushed
the
feat/docs-skills
branch
from
ac8b890 to
a2c59bb
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new Skills surface to the docs — markdown playbooks that teach AI agents how to do music industry work. Skills complement the API: the API tells an agent how to take action, Skills tell it when and why.
What's a Skill?
A directory in recoupable/skills with a `SKILL.md` root file. Agents read the `description` field in the frontmatter to decide when to invoke it. Each skill packages domain expertise (playlist pitching, artist research, release planning) in a form that Claude Code, Cursor, or any MCP-compatible agent can install with one command.
Pages added
What this PR does NOT do
Stack
PR 6 of 7. Replaces #145.
Test plan
Made with Cursor