feat(dev3000): add dev3000 (d3k) debugging plugin via skills.sh#225
Merged
Conversation
Wraps Vercel Labs' official d3k skill (vercel-labs/dev3000, skills/d3k), which captures server/browser logs and screenshots into a unified debug timeline for Next.js and other web apps. - Plugin installed via bunx skills add with skills-lock.json tracking - Skill loaded from .agents/skills/d3k/ (SKILL.md + PUBLISH.md + agents/) - Generated Codex manifest (.codex-plugin/plugin.json) and Antigravity manifest (root plugin.json) via bun scripts/cli.ts multi-format - Added dev3000 entry to .claude-plugin/marketplace.json (source of truth) - Regenerated .agents/plugins/marketplace.json (Codex marketplace) - Added plugins/dev3000 package to release-please-config.json and .release-please-manifest.json at version 1.0.0 - Added Built-in Plugins entry and install-list line to README.md
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (5)
✅ Files skipped from review due to trivial changes (2)
🚧 Files skipped from review as they are similar to previous changes (3)
📝 WalkthroughWalkthroughAdds a new Changesdev3000 Plugin Addition
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
🔍 Tessl Skill Review
|
| Dimension | Score | Detail |
|---|---|---|
| conciseness | ██░ 2/3 | The content is mostly efficient but includes some unnecessary explanation (e.g., the 'Why d3k-first' section explains motivations Claude doesn't need, and some practical rules are somewhat verbose). The Browser Tool Choice section, while useful, could be tightened. However, most of the content is actionable and not padded with basic concept explanations. |
| actionability | ███ 3/3 | The skill provides fully executable, copy-paste-ready bash commands throughout. Every step includes concrete commands with specific flags, and the examples cover installation, startup, debugging, and browser control with real CLI invocations. |
| workflow clarity | ███ 3/3 | Multi-step processes are clearly sequenced with numbered steps and explicit validation checkpoints (e.g., 'Verify the server before opening more browser windows' with curl -I, sanity-check with snapshot/errors). The Codex Fresh Browser workflow includes a feedback loop for handling wedged servers and clear ordering constraints (close stale daemon → start server → verify → open browser). |
| progressive disclosure | ██░ 2/3 | The content is well-organized with clear section headers, but it's a fairly long monolithic file with no references to external files for detailed content. The Browser Tool Choice comparison and the Codex Fresh Browser workflow could potentially be split into separate reference files. However, with no bundle files provided, the inline approach is acceptable though not ideal. |
Overall: This is a strong, actionable skill with excellent workflow clarity and concrete executable commands throughout. Its main weakness is moderate verbosity—the 'Why d3k-first' rationale section and some practical rules could be trimmed since Claude doesn't need motivation or extensive edge-case prose. The content would benefit from slightly tighter writing and potentially splitting the longer sections into referenced files.
Suggestions:
- Remove or drastically shorten the 'Why d3k-first' section—Claude doesn't need motivation, just instructions on when and how to use d3k.
- Consider extracting the 'Codex Fresh Browser/Profile Startup' and 'Browser Tool Choice' sections into separate referenced files to improve progressive disclosure and reduce the main file's length.
To improve your score, point your agent at the Tessl optimization guide. Need help? Jump on our Discord.
Feedback
Report issues with this review at tesslio/skill-review, or send private feedback from your terminal with tessl feedback.
Up to standards ✅🟢 Issues
|
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
본 풀 리퀘스트는 새로운 dev3000 (d3k) 디버깅 어시스턴트 플러그인을 추가합니다. 변경 사항에는 마켓플레이스 설정 파일에 플러그인을 등록하고, 릴리스 매니페스트 및 설정을 업데이트하며, README에 설치 안내를 추가하는 작업이 포함됩니다. 또한 plugins/dev3000/ 경로 아래에 플러그인 메타데이터와 skills.sh를 통해 설치된 d3k 스킬 파일들을 추가했습니다. 검토할 리뷰 댓글이 없으므로 별도의 피드백은 제공하지 않습니다.
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/dev3000/.claude-plugin/plugin.json`:
- Around line 1-21: The plugin.json file at .claude-plugin/plugin.json is
missing the required `mcpServers` field. According to the coding guidelines,
this field must be present in the Claude plugin manifest alongside the existing
name, version, and description fields. Add the `mcpServers` field to the JSON
object in the plugin.json file, ensuring it follows the proper JSON structure
and includes the appropriate configuration for MCP servers as defined in the
repository guidelines.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: b2a2f04f-a4a7-4924-8563-1ea9a18167c3
📒 Files selected for processing (12)
.agents/plugins/marketplace.json.claude-plugin/marketplace.json.release-please-manifest.jsonREADME.mdplugins/dev3000/.agents/skills/d3k/PUBLISH.mdplugins/dev3000/.agents/skills/d3k/SKILL.mdplugins/dev3000/.agents/skills/d3k/agents/openai.yamlplugins/dev3000/.claude-plugin/plugin.jsonplugins/dev3000/.codex-plugin/plugin.jsonplugins/dev3000/plugin.jsonplugins/dev3000/skills-lock.jsonrelease-please-config.json
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
No issues found across 12 files
Confidence score: 5/5
- Automated review surfaced no issues in the provided summaries.
- No files require special attention.
Architecture diagram
sequenceDiagram
participant User as User / Developer
participant CC as Claude Code CLI
participant Registry as Plugin Registry (marketplace.json)
participant PM as Plugin Manager
participant D3KPlugin as dev3000 Plugin Plugin
participant SkillsSH as skills.sh (bunx skills add)
participant D3KSkill as d3k Skill (SKILL.md)
participant D3KRuntime as dev3000 (d3k) Runtime
participant Browser as Browser (CDP / agent-browser)
participant DevServer as Dev Server (npm/bun dev)
Note over User,DevServer: Installation & Activation Flow
User->>CC: /plugin install dev3000@pleaseai
CC->>Registry: Lookup dev3000 source
Registry-->>CC: Source: ./plugins/dev3000
CC->>PM: Install plugin from plugins/dev3000
PM->>D3KPlugin: Load .claude-plugin/plugin.json
D3KPlugin-->>PM: skills: "./.agents/skills/"
PM->>SkillsSH: bunx skills add (install d3k skill)
alt First install or missing skill
SkillsSH->>D3KSkill: Fetch from vercel-labs/dev3000
D3KSkill-->>SkillsSH: SKILL.md + agents/openai.yaml
SkillsSH->>SkillsSH: Write to .agents/skills/d3k/
SkillsSH-->>PM: Skills-lock.json updated
end
PM-->>CC: Plugin installed
CC-->>User: dev3000 ready
Note over User,Browser: Runtime Activation & Debugging Flow
User->>CC: Debug this app (debugging context detected)
CC->>D3KSkill: Activate d3k skill
D3KSkill->>User: Prompt: use $d3k
User->>D3KRuntime: d3k --no-agent --no-tui -t
D3KRuntime->>DevServer: Launch via --command (npm run dev)
DevServer-->>D3KRuntime: Server running on port 3000
D3KRuntime-->>User: Timeline capture active
User->>D3KRuntime: d3k logs -n 200
D3KRuntime-->>User: Server + browser logs
User->>D3KRuntime: d3k agent-browser open http://localhost:3000
D3KRuntime->>Browser: Launch/connect CDP browser
Browser->>DevServer: HTTP request to localhost:3000
DevServer-->>Browser: Page rendered
Browser-->>D3KRuntime: CDP events (console, network, screenshots)
D3KRuntime-->>User: Unified timeline updated
alt Debugging with fresh profile
User->>D3KRuntime: d3k agent-browser close --all
User->>D3KRuntime: d3k --servers-only --command "npm run dev -- -H 127.0.0.1 -p 3000"
D3KRuntime->>DevServer: Start server only (no monitored browser)
User->>D3KRuntime: d3k agent-browser --profile /tmp/fresh --headed open ...
D3KRuntime->>Browser: Launch separate browser with fresh profile
end
Note over User,D3KSkill: Key Principle<br/>Run d3k, not npm/bun dev directly
# Conflicts: # .agents/plugins/marketplace.json # .claude-plugin/marketplace.json # .release-please-manifest.json # README.md # release-please-config.json
amondnet
enabled auto-merge (squash)
June 20, 2026 02:29
Merged
|
5 tasks
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
1 participant
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
Add the dev3000 plugin to the marketplace. dev3000 is Vercel Labs' official
debugging skill (
d3k) that captures server logs, browser console output, andscreenshots into a unified timeline — making it easy to diagnose Next.js and
other web-app issues without manually correlating multiple sources.
What changed
plugins/dev3000/— new plugin directory containing:.claude-plugin/plugin.json— source-of-truth Claude Code manifest(
"skills": "./.agents/skills/").agents/skills/d3k/— skill files installed viabunx skills add(SKILL.md, PUBLISH.md, agents/openai.yaml); tracked by
skills-lock.json.codex-plugin/plugin.json+ rootplugin.json— generated Codex andAntigravity manifests (via
bun scripts/cli.ts multi-format).claude-plugin/marketplace.json— added dev3000 entry (source of truth).agents/plugins/marketplace.json— regenerated Codex marketplace(only dev3000 added, unrelated churn reverted)
release-please-config.json— addedplugins/dev3000package.release-please-manifest.json— addedplugins/dev3000: "1.0.0"README.md— added Built-in Plugins entry and install-list lineApproach: skills.sh (not SessionStart hook)
This plugin uses the recommended skill-based activation pattern:
bunx skills addinstalls the upstream d3k skill under.agents/skills/d3k/, and Claude loads it only when debugging contextis detected — avoiding the per-session token cost of a SessionStart hook.
Validation
claude plugin validatepassed for both the plugin manifest and themarketplace manifest before this PR was opened.
Install
Summary by cubic
Adds the
dev3000plugin that wraps Vercel Labs’d3kskill to provide unified server and browser logs, network events, and screenshots. Runsd3kas the dev runtime and uses its monitored browser via CDP instead ofnpm/bun dev.New Features
plugins/dev3000with.agents/skills/d3k(installed viabunx skills add) andskills-lock.json..claude-plugin/plugin.json,.codex-plugin/plugin.json, and rootplugin.json..claude-plugin/marketplace.jsonand.agents/plugins/marketplace.json.release-please-config.jsonand.release-please-manifest.jsonat version1.0.0.README.mdwith install instructions and Built-in Plugins entry.Migration
/plugin marketplace add pleaseai/claude-code-plugins/plugin install dev3000@pleaseaiWritten for commit 9eda4d2. Summary will update on new commits.
Summary by CodeRabbit
New Features
Documentation