comet

name	comet
description	Submit Perplexity Comet searches and Deep Research jobs through Chrome DevTools Protocol without blocking the main Claude Code session. Use when the user asks to use Comet, Perplexity, Deep Research, model council, browser research, or uploaded-file research. The skill submits the job, returns a handoff file and `/search/<id>` URL, and only captures the completed answer if explicitly requested.

Comet CDP Handoff

Use this skill to hand research work to Perplexity Comet quickly and reliably.

Core rule: do not use blocking ask tools for substantive Comet work. Submit through CDP, validate the /search/<id> URL, write a handoff record, and leave the Comet tab open.

Execution Contract

• Use the Task tool with subagent_type: general-purpose when available, so the main Claude context stays clean.
• The main session classifies the request and returns only the headline, submitted URL, and handoff path.
• The subagent connects Comet, runs the CDP handoff, and returns only JSON.
• Do not paste raw Comet output into the main session unless the user asks to capture/export the completed answer.

Classify

• Deep Research: competitive landscape, due diligence, multi-source synthesis, citations, long research.
• Search: quick factual lookup or source finding.
• Uploaded-file research: upload files before inserting the prompt.
• Connector research: enable the connector first if the MCP bridge supports it, then include the @connector mention in the prompt.
• Model Council, Labs, Learn, or Computer: use only if the UI can be selected reliably; otherwise return a blocker instead of falling back to a slow blocking call.

Preferred Tool Path

1. If available, call the comet_bridge MCP comet_connect tool to start/connect Comet.
2. Verify CDP is live at http://127.0.0.1:9222/json/version.
3. Use the bundled script from the skill directory:

node scripts/submit-comet-cdp.js \
  --mode research \
  --prompt-file /absolute/path/to/prompt.txt \
  --file /absolute/path/to/evidence.pdf

For inline prompts:

node scripts/submit-comet-cdp.js \
  --mode search \
  --prompt "Find the best current sources on browser-agent CDP automation."

If the script is not available, reproduce its protocol directly:

1. Open a fresh Perplexity tab with PUT http://127.0.0.1:9222/json/new?https://www.perplexity.ai/.
2. Activate the target and enable Runtime, DOM, and Page.
3. Focus #ask-input,[contenteditable=true][role=textbox] with real mouse events.
4. For Deep Research, dispatch / keydown/char/keyUp, wait for Search mode and Deep research, press Return, then wait for the Deep Research pill.
5. Upload files through input[type=file] with DOM.setFileInputFiles.
6. Wait for filenames to appear, data-testid="file-loading-icon" to disappear, and disabled file chips to clear.
7. Insert prompt text with Input.insertText.
8. Locate the enabled submit button, compute its center, and dispatch mouseMoved, mousePressed, mouseReleased.
9. Validate the final URL includes /search/ and does not include /search/new/.

Output Contract

Return only:

{
  "handoff_path": "/absolute/path/to/handoff.md",
  "search_url": "https://www.perplexity.ai/search/...",
  "headline": "Short summary of submitted job",
  "mode_used": "research"
}

If blocked:

{"handoff_path": null, "error": "short reason"}

Do Not

• Do not use blocking Comet ask calls for substantive work.
• Do not call old perplexity-comet MCP tools.
• Do not use synthetic DOM clicks for mode menus, submit buttons, or export menus.
• Do not reuse failed draft tabs.
• Do not wait for full Deep Research completion unless explicitly asked.
• Do not post, email, publish, or invite through connectors unless explicitly asked.

Export Later

If the user asks for the completed report, activate the completed /search/<id> tab, coordinate-click the last visible Download button, wait for the PDF/Markdown/DOCX menu, coordinate-click the requested format, and watch the downloads folder.