Document the kagent-tools example Agents and skills

Abierto
  • ¿Algo no está bien?
#680 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
25/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
docker, go, helm, kubernetes
Área
ai, documentation

Línea de trabajo

Do not start yet: the issue says to wait until kagent-dev/kagent#3417 merges and a kagent-tools release ships. Once it does, read the merged exampleAgents values in the chart and the skills under /opt/kagent-tools-skills from kagent-dev/tools#91. Edit 1.x/examples/ or 1.x/examples/skills.md, then regenerate 1.x/reference/helm.md rather than editing it by hand. Done when the seven skills and their example Agents are listed and the two stated limits are documented.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Do not action before kagent-dev/kagent#3417 merges and ships in a kagent release. The 1.x pages are correct against the shipped release today.

kagent 0.x shipped ready-made example agents (k8s, istio, helm, cilium, and others) as Helm charts, and the 0.x docs pointed users at them. 1.x has no equivalent yet. Two upstream changes restore one:

  • kagent-dev/tools#91 (merged 2026-10-29) ports the agents' domain guidance to seven Agent Skills in the kagent-tools image, under /opt/kagent-tools-skills. No kagent-tools release contains it yet; v0.3.0 and earlier have no skills.
  • kagent-dev/kagent#3417 (open) adds exampleAgents.enabled, off by default. It installs one Go ADK Harness, kagent-tools-example, and three Agents: kagent-tools-cluster-ops, kagent-tools-networking, and kagent-tools-security. It waits on kagent-dev/tools#98 and a kagent-tools release.

Docs work

  • Document the exampleAgents Helm values on 1.x/examples/, or add a section to 1.x/examples/skills.md. Placement is the open question below.
  • List the seven skills and which example Agent loads each one.
  • Show how to attach one of the skills to a user's own Agent, from the kagent-tools image pinned by digest.
  • State the limits the PR names: OCI skill sources only until kagent-dev/kagent#3435 merges, and a custom snapshotLocation when the Substrate chart's rustfs store is off.
  • Regenerate 1.x/reference/helm.md; do not hand-edit it.

Check before starting

  • The merged values in kagent#3417 match the PR body, and exampleAgents.skillsImage is optional in the released chart.
  • The skill names in the released kagent-tools image match tools#91.

Open question

A new example page, or a section on the existing 1.x/examples/skills.md?

Lenguaje dominante
TypeScript
Estrellas
21
Forks
71
Merge medio
17 h 19 min
PR fusionados (30 d)
87

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de kagent-dev/website

Todos los issues de kagent-dev/website

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.