title	Sunbeam Skills

Sunbeam Skills

A curated collection of Kimi Code-compatible agent skills for Sunbeam Studios.

This repository contains:

• Sunbeam originals — skills built specifically for our workflows
• Ported skills — third-party skills adapted from Claude Code, Deno, and other ecosystems, cleaned for Kimi compatibility

Skill Inventory

Sunbeam Originals

Skill	Purpose
sunbeam-ai-slop-cleaner	Clean AI-generated code slop
sunbeam-beam-ui	Beam UI component system
sunbeam-bug-report	MVCE + GWT bug report templates
sunbeam-callgraph-debugger	Iterative DAG completion for complex callgraph debugging
sunbeam-cli	Sunbeam CLI conventions
sunbeam-deepinit	Deep codebase initialization with hierarchical AGENTS.md
sunbeam-deploy-verify	Deployment verification procedures
sunbeam-external-context	Parallel research agents for external web searches
sunbeam-g2v	G2V workflow
sunbeam-g2v-fe	G2V frontend workflow
sunbeam-manifest	Manifest management
sunbeam-port-loop	Port loop handling
sunbeam-profiles	Profile management
sunbeam-release	Rust + TypeScript release assistant
sunbeam-research	Parallel subagent research orchestration
sunbeam-rfc-design	IETF-grade RFC design documents
sunbeam-self-healing-deploy	Self-healing deployment patterns
sunbeam-skill-migrator	Port and clean third-party skills
sunbeam-skillify	Turn repeatable workflows into reusable skills
sunbeam-spec-to-service	Spec-to-service generation
sunbeam-stack	Stack management
sunbeam-standup	Daily standup from kanban cards + git history
sunbeam-trace	Evidence-driven causal tracing
sunbeam-verify	Verify changes with concrete evidence
sunbeam-visual-verdict	Structured visual QA for screenshot comparisons
sunbeam-wfe	WFE workflow

Ported Skills

Source	Skills	Original License
Addy Osmani / web-quality-skills	addyosmani-accessibility, addyosmani-best-practices, addyosmani-core-web-vitals, addyosmani-performance, addyosmani-seo, addyosmani-web-quality-audit	MIT
Deno Land	deno-expert, deno-frontend, deno-guidance, deno-project-templates, deno-sandbox	MIT
Trail of Bits	tob-ask-questions-if-underspecified, tob-audit-context-building, tob-differential-review	CC BY-SA 4.0
Vercel	vercel-composition-patterns	See skill directory

Note: Ported skills have been cleaned of platform-specific references (Claude CLI commands, ~/.claude/ paths, etc.) and updated with origin metadata per our sunbeam-skill-migrator procedure.

Agent Inventory

Custom Kimi agents live in agents/ and define specialized system prompts + subagent orchestration.

Agent	Purpose	Subagents
sunbeam-callgraph-debugger	Debug complex callgraphs via iterative DAG completion	graph-extractor, frontier-explorer, edge-analyzer

Using a Custom Agent

# Launch Kimi with the custom agent
kimi --agent ./agents/sunbeam-callgraph-debugger/agent.yaml

# Or add to your Kimi config for persistent use

Agent definitions are YAML files that extend Kimi's built-in default agent with custom system prompts and subagent configurations. Each agent directory contains:

• agent.yaml — main agent definition with subagent registry
• system.md — system prompt template (supports ${KIMI_NOW}, ${KIMI_WORK_DIR}, ${KIMI_AGENTS_MD}, custom args)
• *.yaml — subagent definitions that inherit from the main agent

How It Works

Submodules

External skill repos are tracked as git submodules under submodules/:

# List all submodules
git submodule status

# Update all submodules to latest
./update-skills.sh

The Update Script

update-skills.sh performs three operations:

1. git submodule update --init --remote — pulls latest changes from all sources
2. Copies skills from submodules into skills/ with optional prefixes
3. Preserves local skills — Sunbeam originals and previously ported skills are never overwritten

Sources Registry

sources.json maps each submodule to its skill path and prefix:

[
  {
    "name": "denoland-skills",
    "submodule": "submodules/denoland-skills",
    "skillPath": "skills",
    "prefix": "deno"
  }
]

Field	Description
name	Human-readable source name
submodule	Path to the submodule directory
skillPath	Relative path inside the submodule where skills live
prefix	Optional prefix for skill directory names
localPath	(Alternative) Path to local skills outside submodules

Adding a New Skill

Option A: External Source (Submodule)

# Add the repo as a submodule
git submodule add https://github.com/<org>/<repo>.git submodules/<name>

# Register it in sources.json
# Run the update script
./update-skills.sh

Option B: Local Skill (Sunbeam Original)

# Create the skill directory and SKILL.md directly
mkdir -p skills/my-new-skill
cat > skills/my-new-skill/SKILL.md << 'EOF'
---
name: my-new-skill
description: What this skill does and when to use it.
license: MIT
metadata:
  author: sunbeam
  version: "1.0.0"
---

# My New Skill

Content here...
EOF

Local skills are never touched by update-skills.sh.

Migrating a Copied Skill

When copying skills from external sources, run them through the migration procedure:

1. Read skills/sunbeam-skill-migrator/SKILL.md
2. Apply the 5-step migration procedure (preserve license, clean refs, update frontmatter, etc.)
3. Add the skill to the inventory table above

License

This repository is licensed under the MIT License. See LICENSE for full terms.

Ported skills retain their original licenses and attribution, noted in each skill's frontmatter and in the LICENSE file.