Improve OpenBB Skill Skill

Improve OpenBB Skill

When you discover issues or improvements needed in the openbb-app-builder skill documentation, use this skill to submit fixes to the upstream repository.

When to Use

Trigger this skill when:

You find incorrect documentation in the openbb-app-builder skill
An example doesn't work as documented
A feature is missing from the documentation
You learn the correct format through trial and error with OpenBB Workspace
User asks to "fix the skill", "update the docs", or "submit improvements"

Common Issues to Fix

| Issue Type | Example | |------------|---------| | Wrong format | apps.json documented as array but is actually object | | Missing fields | Required fields like name in groups not documented | | Wrong values | type: "endpointParam" should be type: "param" | | Missing endpoint | /apps.json endpoint not mentioned | | Missing features | state object for pre-configuring widgets |

Workflow

Step 1: Identify Changes

Document what needs to be fixed:

Which file(s) in .claude/skills/openbb-app-builder/
What is currently wrong
What the correct information should be

Step 2: Make Local Fixes First

Fix the skill files in the current project:

.claude/skills/openbb-app-builder/
├── SKILL.md
└── references/
    ├── OPENBB-APP.md
    ├── DASHBOARD-LAYOUT.md
    ├── WIDGET-METADATA.md
    └── ...

Step 3: Clone and Branch

cd /tmp && rm -rf backends-for-openbb
gh repo clone OpenBB-finance/backends-for-openbb
cd backends-for-openbb
git checkout -b fix/skill-{description}

Step 4: Copy Updated Files

cp /path/to/local/.claude/skills/openbb-app-builder/SKILL.md \
   /tmp/backends-for-openbb/.claude/skills/openbb-app-builder/

cp /path/to/local/.claude/skills/openbb-app-builder/references/*.md \
   /tmp/backends-for-openbb/.claude/skills/openbb-app-builder/references/

Step 5: Commit and Push

git add .
git commit -m "$(cat <<'EOF'
fix(skill): {short description}

{bullet points of what was fixed}

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: {model} <noreply@anthropic.com>
EOF
)"

git push -u origin fix/skill-{description}

Step 6: Create PR

gh pr create --title "fix(skill): {description}" --body "$(cat <<'EOF'
## Summary
{bullet points of changes}

## What was wrong
{explain the issue}

## What is now correct
{explain the fix}

## Test plan
- [ ] Build an app using the updated documentation
- [ ] Verify the examples work correctly

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

Target Repository

Repo: OpenBB-finance/backends-for-openbb
Skill path: .claude/skills/openbb-app-builder/
Main files:
- SKILL.md - Main skill entry point
- references/OPENBB-APP.md - Backend and apps.json docs
- references/DASHBOARD-LAYOUT.md - Layout and grouping docs
- references/WIDGET-METADATA.md - Widget parameter docs

Example

Scenario: You discover apps.json should be an object, not an array.

Fix local .claude/skills/openbb-app-builder/references/OPENBB-APP.md
Clone OpenBB-finance/backends-for-openbb to /tmp/
Create branch fix/skill-apps-json-format
Copy the fixed file
Commit: fix(skill): correct apps.json format - object not array
Push and create PR
Return PR URL to user

Proactive Usage

When working with openbb-app-builder and you encounter errors like:

"Invalid schema" from OpenBB Workspace
"Expected X - Received Y" validation errors
Features that work differently than documented

Immediately consider using this skill to fix the documentation for future use.

Agent Skills: Improve OpenBB Skill

Install this agent skill to your local

Skill Files