--- name: gsk-create-task version: 1.0.0 description: Create and execute tasks using specialized AI agents. Supports super_agent, podcasts, docs, slides, deep_research, website, video_generation, audio_generation, meeting_notes, cross_check, media_agent, and custom_super_agent (a user-created custom agent; requires agent_config_id). The returned data.task_url is owner-only until shared from that page. To re-fetch a created task's link or outcome, use `gsk task status` — re-running `gsk task create` creates and bills a new task. metadata: category: general requires: bins: - gsk cliHelp: gsk task create --help --- # gsk-create-task **PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules. Create and execute tasks using specialized AI agents. Supports super_agent, podcasts, docs, slides, deep_research, website, video_generation, audio_generation, meeting_notes, cross_check, media_agent, and custom_super_agent (a user-created custom agent; requires agent_config_id). The returned data.task_url is owner-only until shared from that page. To re-fetch a created task's link or outcome, use `gsk task status` — re-running `gsk task create` creates and bills a new task. ## Usage ```bash gsk task create [options] ``` ## Flags | Flag | Required | Description | |------|----------|-------------| | `` (positional) | Yes | The type of task to create: - super_agent: Create general super agent - podcasts: Create audio podcasts with AI characters - docs: Create and edit HTML/Markdown documents. Create a professional document with Word-like formatting as a single-file HTML. Perfect for reports, articles, academic papers, and formal documents. **Guidelines** 1. This tool can be directly called when user explicitly wants to create: - A document or report - An article or academic paper - A formal document with professional formatting - A document for print or PDF export 2. In situations other than those mentioned above, you need to ask the user first and only call this tool after getting permission when user wants to create: - A better formatted text, but hasn't explicitly mentioned creating a document - Content that needs professional document formatting **Limitations** - Document styling resembles Microsoft Word format, not web page design - Usually takes time to generate, so please strictly follow the guidelines above **File inputs** - If the user uploaded a source file (PDF/Word/Markdown/text) for the agent to process or convert, embed the URL (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context. - slides: Create presentation slides. Create an editable slide deck and display it; it exports/downloads as PPTX or PDF. DEFAULT for any presentation, deck, or PowerPoint request — including a downloadable .pptx or redesigning an uploaded .pptx; do NOT rebuild decks in code or raw HTML. EXCEPTION — simple mechanical edits to an uploaded .pptx (insert/delete a slide, change a value, swap an element/image): do them yourself with python-pptx on the original file and deliver the edited file; this agent re-authors the deck and its export is a re-render, so untouched slides won't stay byte-identical. Route substantial rework (redesign, restyle, use as a template, content overhaul) to this agent. The finished deck's page (task_url) has built-in PPTX/PDF export — NEVER create another task to export or convert an existing deck; use task_status to re-fetch a deck's link. Limitation: a) It usually takes minutes. Ask the user whether they want to wait for a longer time before starting if they haven't explicitly indicated they want to generate a set of slides; - website: Create a professional agent for building websites and web pages - deep_research: Create deep research agent for task on a 'deep research' topic (e.g. 'deep research on Tesla', 'analyze Tesla in depth'). Also can handle user's 'continue deep research' request - download: Download a file, video, or audio from the internet into the user's AI Drive and return a long-lived shareable link. Use when the user wants to 'download this', 'save this video/file', or 'get me a link to this'. The agent locates the real downloadable resource (searching/crawling a page if needed), downloads it, and returns the AI Drive path plus a durable share URL. - design: Genspark Design (Designer 2.0): the persistent visual web/HTML design canvas for landing pages, marketing sites, posters, slides-as-pages, and interactive UI mockups. It pre-creates a stable project_id and hands the user its Web canvas with query and instructions combined into the single visible prompt field (the user submits it there). The same project can later be inspected with task_status and edited with task_continue. Use when the user wants a web page / site / poster / visual layout they will iterate on in the Design canvas. - video_generation: Large-scale batch video generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step video pipelines where tasks depend on each other's outputs. Supports text-to-video, image-to-video (query should contain the image url), and merging multiple video clips. Can reuse agent. NOT recommended for small-scale, simple, or independent video tasks — for those, use video_generation directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - audio_generation: Large-scale batch TTS (text-to-speech) generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step TTS pipelines where tasks depend on each other's outputs. Supports text-to-speech, voiceovers, multi-speaker dialogues, and merging multiple audio clips. Can reuse agent. NOT recommended for small-scale, simple, or independent TTS tasks — for those, use audio_generation directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - cross_check: Fact-check and verify claims or statements. Use when the user wants to verify whether a statement is true, check facts, or cross-reference claims against multiple sources. The agent systematically searches for evidence, evaluates source credibility, and provides a detailed verification report with supporting references. - meeting_notes - sheets - custom_super_agent: Execute a user-created custom AI agent. Requires agent_config_id parameter which should be extracted from the workflow step data. These are personalized agents created by users with specific capabilities and configurations. (string, one of: super_agent, podcasts, docs, slides, website, deep_research, download, design, video_generation, audio_generation, cross_check, meeting_notes, sheets, custom_super_agent) | | `--task_name` | Yes | Name for the task/project (string) | | `--query` | Yes | Query for the task. The ending should clearly state what needs to be done, such as generating a doc/slides etc. The sub-agent sees ONLY what is passed via query/instructions — it cannot read your conversation. When you have already produced material for this task (research notes, analysis, drafts, exact figures), embed its FULL text verbatim in the query, NOT a summary or paraphrase: any detail omitted here is missing from the deliverable, and a query carrying such material is naturally long — do not shorten it. For a simple request with no pre-existing material, a concise query is fine. If the user uploaded files or you have data the sub-agent needs, embed the file URLs (file_wrapper_url, http(s)://, or aidrive://) directly in the query — sub-agents do not inherit parent context, so unreferenced files are invisible to them. (string) | | `--instructions` | Yes | Detailed instructions for the task. This will be set as system prompt to the specialized agent. State the working constraints here: audience, structure, style, output format, and what must be preserved exactly (figures, citations, links). Do not spend this field on a bare persona line like 'You are a professional slides assistant' — that gives the sub-agent nothing to work with. Include any file URLs (file_wrapper_url, http(s)://, or aidrive://) the sub-agent must reference; the sub-agent only sees what is passed via query/instructions. Design is the exception to the system-prompt transport: its Web canvas has one visible prompt field, so create_task appends instructions under an 'Additional requirements' heading in that field for the user to review before submitting. (string) | | `--agent_config_id` | No | Agent config ID for loading agent configuration. Required when task_type is 'custom_super_agent' - the ID of the user's custom agent. Optional when task_type is 'dynamic' - if provided, loads config from this ID instead of generating a new one dynamically. (string) | | `--artifact_refs` | No | Optional artifact ids ('#', from `gsk task artifacts` or `gsk task artifact `) whose current files are imported into the task — pass an earlier task's output into this one by reference. Resolved at create time: any unknown/inaccessible ref fails the call immediately. Entries marked `requires_export: true` in the artifacts listing (HTML/Markdown docs, slides decks) cannot be passed directly — run `gsk task export` first and pass the returned download_url via file_urls. (array) | | `--attachments` | No | For `design` tasks: ordered structured references shown in the native Design attachment area. URLs may be private file-wrapper, https, or aidrive URLs. Each item preserves its original name, MIME type, and semantic role. (array) | | `--wait` | No | Default false: the task is SUBMITTED to the durable runtime and this call returns immediately with its run_id — poll `gsk task status ` until it finishes, stop it with `gsk task stop `. Pass true to block until the task completes and get the full result inline (legacy behavior; generation can take 5-30+ minutes, so set your shell timeout to 1800000 ms). (boolean) | > **CAUTION:** This command performs a write/send operation. Double-check parameters before executing. ## See Also - [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags