docs: add an explainer for the boundaries between prompts, plugins/skills, custom scripts, and agent execution
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 48/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- markdown
- Área
- documentation
Línea de trabajo
Start by reading the Automations Overview and Agent Canvas managing-automations pages, then compare their terminology with extensions#816 and OpenHands#16412. Draft a comparison and decision table covering prompts, plugin-based and plugin-spec automations, custom scripts, skills, and agent execution. Done means the new page or section is cross-linked from both docs pages and uses taxonomy consistent with extensions#816.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem or Motivation
A user interview with a CTO and self-described power user showed they struggled to understand the boundaries between prompts, plugins/skills, custom scripts, and agent execution — even while evaluating automations in Agent Canvas. The concepts are each documented somewhere, but no page explains when to use which and how they compose.
Desired Behavior
Add a single docs page (Agent Canvas > Automations, or a concepts page) that explains, at a glance:
- Prompt-based automations — natural-language scheduled tasks; best for reports, monitoring, one-off LLM work.
- Plugin-based automations / plugin presets — automations that bundle plugins providing skills or capabilities; the extensions catalog path.
- Plugin-spec automations — reusable, code-backed, deterministic automations packaged as executable plugins (being documented in OpenHands/extensions#816 / PR #794).
- Custom scripts (
.automation.json/ tarball presets) — full packaging control and SDK lifecycle. - Skills vs plugins — what each is, where they live (scopes), and how they relate to automations and agent execution.
Include a comparison/decision table (similar in spirit to AmpCode's skills-locations table referenced in OpenHands/OpenHands#16412) and link it from:
- The Automations Overview page
- The Automations dashboard "Learn more" target
- OpenHands/OpenHands#16412's skills/plugins clarity work
Acceptance Criteria
- A new page (or clearly marked section) explaining the boundaries and when to use each.
- Cross-linked from the Automations docs and the Agent Canvas managing-automations page.
- Reviewed for consistency with extensions#816's plugin-spec documentation (same taxonomy, not competing ones).
References
- OpenHands/OpenHands#16412 (skills & plugins scopes consistency)
- OpenHands/extensions#816 (plugin-spec docs)
- OpenHands/OpenHands#16571 (SDLC automations guide)
This issue was created by an AI agent (OpenHands) on behalf of Graham Neubig.
- Lenguaje dominante
- MDX
- Estrellas
- 19
- Forks
- 104
- Merge medio
- 2 d 12 h
- PR fusionados (30 d)
- 80
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de OpenHands/docs
-
docs: document FORGEJO_BASE_URL (self-hosted Forgejo host for the backend integration)Posiblemente ocupada @remote-controlled-man la tomó hace 18 días. Abierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
Los mantenedores suelen responder en 1 día
-
docs(sdk): custom-tools 'register_tool' example passes a factory function, which raises TypeErrorAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 83/100
Los mantenedores suelen responder en 1 día
-
Docs: Child Conversations incorrectly implies the child's result is returned to the parentPosiblemente ocupada @sahithib20 la tomó hace 36 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
OpenHands/docs#658 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
Todos los issues de OpenHands/docs
Issues similares
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
ethereum/execution-apis#1017 ·
Los mantenedores suelen responder en 3 días
-
[Docs] CONTRIBUTING points the Backend Remake milestone at a branch that does not existPosiblemente ocupada @franpts2 la tomó hoy. Abiertodocs
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
Los mantenedores suelen responder en 3 días
-
postgresql-rules / queue-rules: implicit KEY SHARE before a parent key update, and job self-overlapAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
jonathanong/no-mistakes#3879 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
pearu/agent-sandbox#451 ·
Los mantenedores suelen responder en 1 día