Habilidades openserv-agent-sdk

📦

openserv-agent-sdk

Name: openserv-agent-sdk
Author: internet-court

Revisión del contenido r1 Riesgo alto ⚙️ Comandos externos🌐 Acceso a red🔑 Variables de entorno⚡ Contiene scripts

Crear agentes de IA de OpenServ

Los desarrolladores necesitan una guía clara para crear agentes de OpenServ sin omitir los requisitos de la plataforma. Esta skill explica patrones del SDK, aprovisionamiento, despliegue, resolución de problemas y flujos de trabajo de agentes.

Compatible con: Claude Codex Code(CC)

⚠️ 38 Deficiente

Maintain this Skill? Claim it ⚠️ 38 Deficiente

Detente y solicita confirmación antes de instalar.

Revisa el plan y obtén el consentimiento explícito del usuario antes de modificar archivos.

Instalar con mi Agente

Copia esta solicitud en tu Agente. Incluye la página canónica del Skill y el manifiesto.

Solicitud de agente

Review the Skillstore skill "openserv-agent-sdk" from https://skillstore.io/skills/internet-court-openserv-agent-sdk.md and its manifest at https://skillstore.io/api/skills/internet-court-openserv-agent-sdk/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

Tu Agente debe seguir mostrando su plan y solicitar cualquier confirmación exigida por la política de seguridad.

Recursos legibles por agentes

Usa estos enlaces cuando un agente de IA, crawler o script necesite contexto limpio en vez de leer la página completa.

Detalle Markdown GET /skills/internet-court-openserv-agent-sdk.md Manifest firmado GET /api/skills/internet-court-openserv-agent-sdk/manifest Lockfile firmado GET /api/skills/internet-court-openserv-agent-sdk/lockfile

Pruébalo

Usando "openserv-agent-sdk". Quiero un agente con webhook que resuma las notas de los clientes.

Resultado esperado:

Un plan de configuración con el propósito del agente, la lista de capacidades, la elección del activador, la secuencia de aprovisionamiento, recomendaciones sobre tiempos de espera y notas de despliegue.

Usando "openserv-agent-sdk". Mi registro de ERC-8004 falla después del aprovisionamiento.

Resultado esperado:

Una lista de comprobación para resolver problemas que abarque los fondos de la billetera, la carga de la clave privada, el comportamiento de los reintentos y cómo mantener el agente en ejecución.

Usando "openserv-agent-sdk". ¿Esta capacidad debería ser runless o runnable?

Resultado esperado:

Una recomendación que compara la generación gestionada por la plataforma con el código personalizado y, a continuación, explica los requisitos de esquema y registro.

Auditoría de seguridad

Riesgo alto

v2 • 21/7/2026 Abrir el informe versionado

This is a documentation-only skill teaching how to build agents with the OpenServ TypeScript SDK (@openserv-labs/sdk); it ships Markdown reference docs and .ts example files, not an executable installer. Of 248 static hits, 237 are false positives: the "shell backtick execution" flags are JavaScript template literals and Markdown code fences, and the "API/secret key" and ".env" flags are placeholder names in an env.example and configuration prose with no real secrets embedded. 11 findings are kept at low severity for visibility because the documented provision() flow persists a crypto WALLET_PRIVATE_KEY to .env for on-chain (ERC-8004 / x402 / USDC) payments — a transparent, documented behavior a reviewer should be aware of, not exfiltration.

Archivos escaneados

1,559

Líneas analizadas

Elementos de revisión

Falsos positivos ignorados

Preocupaciones de seguridad confirmadas (6)

Alto

reference.md:289

Environment file access

**Important:** `provision()` writes `WALLET_PRIVATE_KEY` to `.env` at runtime. If you use `import 'd

Documents that provision() persists a crypto WALLET_PRIVATE_KEY to the .env file at runtime for on-chain (ERC-8004 / x402 / USDC) payments. This is a transparent, documented capability, not exfiltration, but persisting a wallet private key to disk is genuinely sensitive, so it is kept at low severity for reviewer visibility.

Alto

reference.md:306

Crypto seed/private key mention

privateKey: process.env.WALLET_PRIVATE_KEY!,

Alto

SKILL.md:406

Environment file access

// Reload .env to pick up WALLET_PRIVATE_KEY written by provision()

Alto

SKILL.md:416

Crypto seed/private key mention

privateKey: process.env.WALLET_PRIVATE_KEY!,

Alto

troubleshooting.md:143

Environment file access

**Tip:** After `provision()` runs, the `WALLET_PRIVATE_KEY` is stored in `.env`. Use `dotenv.config(

Bajo

reference.md:289 reference.md:306 SKILL.md:406-416

Documented runtime persistence of a crypto wallet private key to .env

The reference and SKILL docs describe provision() writing WALLET_PRIVATE_KEY into the local .env file at runtime, then reloading it via dotenv.config({ override: true }), so the agent can sign on-chain ERC-8004 registration and x402/USDC payment transactions. This is transparent, intended SDK behavior documented for the developer — not covert exfiltration — but reviewers and users should understand that a spendable private key is stored in plaintext on disk and used to move funds on Base mainnet.

The behavior is explicitly documented as an intended SDK feature for payments, so it is not malicious; the low-but-nonzero confidence reflects the genuine sensitivity of persisting a spendable private key to a plaintext .env rather than any sign of hidden intent.

Elementos de revisión de capacidades (6)

Estas son capacidades locales reales que pueden esperarse para esta habilidad, por lo que requieren revisión, pero no se cuentan como comportamiento malicioso confirmado.

Alto

examples/env.example:10

Generic API/secret keys

WALLET_PRIVATE_KEY=

Alto

reference.md:276

Generic API/secret keys

// Top up credits with USDC (uses WALLET_PRIVATE_KEY env var)

Alto

reference.md:289

Generic API/secret keys

**Important:** `provision()` writes `WALLET_PRIVATE_KEY` to `.env` at runtime. If you use `import 'd

Alto

reference.md:340

Generic API/secret keys

WALLET_PRIVATE_KEY=auto-populated (also used for x402 payments, USDC top-up, and ERC-8004 registrati

Alto

SKILL.md:406

Generic API/secret keys

// Reload .env to pick up WALLET_PRIVATE_KEY written by provision()

Alto

troubleshooting.md:143

Generic API/secret keys

**Tip:** After `provision()` runs, the `WALLET_PRIVATE_KEY` is stored in `.env`. Use `dotenv.config(

Factores de riesgo

⚙️ Comandos externos (50)

examples/basic-agent.ts:27 examples/basic-agent.ts:28 examples/basic-agent.ts:54 examples/capability-example.ts:39 examples/capability-example.ts:43-45 examples/capability-with-agent-methods.ts:34 examples/capability-with-agent-methods.ts:39 examples/capability-with-agent-methods.ts:46 examples/capability-with-agent-methods.ts:65 examples/error-handling.ts:51 examples/file-operations.ts:22 examples/file-operations.ts:43 examples/file-operations.ts:61 examples/haiku-poet-agent.ts:53 examples/haiku-poet-agent.ts:54 examples/multiple-capabilities.ts:41 examples/task-management.ts:44 examples/task-management.ts:97 reference.md:121-127 reference.md:127-134 reference.md:134 reference.md:278-283 SKILL.md:12 SKILL.md:16 SKILL.md:17 SKILL.md:18 SKILL.md:22 SKILL.md:23 SKILL.md:24 SKILL.md:25 SKILL.md:28 SKILL.md:34-36 SKILL.md:36-38 SKILL.md:38 SKILL.md:42-46 SKILL.md:46-47 SKILL.md:47-48 SKILL.md:48 SKILL.md:49-57 SKILL.md:57-64 SKILL.md:64-68 SKILL.md:68-72 SKILL.md:72-74 SKILL.md:74 SKILL.md:78 SKILL.md:80-97 SKILL.md:97-107 SKILL.md:107-109 SKILL.md:109-135 SKILL.md:135-137

🌐 Acceso a red (8)

examples/basic-agent.ts:54 reference.md:265 reference.md:310 reference.md:315 reference.md:317 reference.md:344 SKILL.md:358 SKILL.md:423

🔑 Variables de entorno (50)

examples/basic-agent.ts:9 examples/env.example:3 examples/env.example:4 examples/env.example:7 examples/env.example:10 examples/env.example:11 examples/haiku-poet-agent.ts:9 reference.md:302 reference.md:306 reference.md:302 reference.md:306 reference.md:30 reference.md:289 reference.md:292 reference.md:293 reference.md:298 reference.md:276 reference.md:289 reference.md:297 reference.md:302 reference.md:306 reference.md:331 reference.md:335 reference.md:336 reference.md:338 reference.md:340 SKILL.md:301 SKILL.md:412 SKILL.md:416 SKILL.md:301 SKILL.md:412 SKILL.md:416 SKILL.md:70 SKILL.md:384 SKILL.md:385 SKILL.md:388 SKILL.md:389 SKILL.md:407 SKILL.md:78 SKILL.md:82 SKILL.md:83 SKILL.md:86 SKILL.md:89 SKILL.md:90 SKILL.md:294 SKILL.md:295 SKILL.md:301 SKILL.md:337 SKILL.md:344 SKILL.md:384

⚡ Contiene scripts (4)

troubleshooting.md:175 troubleshooting.md:179 troubleshooting.md:180 troubleshooting.md:186

Auditado por: claude Ver historial de auditorías →

Compartir y citar este informe

Comparte el informe de evaluación versionado, la insignia neutral, la tarjeta insertable y las citas. Skillstore presenta evidencias sin decidir si este Skill es seguro.

Abrir el informe versionado

Copiar enlace del informe

https://skillstore.io/skills/internet-court-openserv-agent-sdk/audits/2?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Insignia Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/internet-court-openserv-agent-sdk/security.svg)](https://skillstore.io/skills/internet-court-openserv-agent-sdk?utm_source=security_passport_badge)

Insignia HTML

<a href="https://skillstore.io/skills/internet-court-openserv-agent-sdk?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/internet-court-openserv-agent-sdk/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Tarjeta para insertar

<iframe src="https://skillstore.io/embed/skills/internet-court-openserv-agent-sdk.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Citas académicas (APA · BibTeX · CFF)

Cita APA

internet-court. (2026). openserv-agent-sdk security audit report (audit version 2) [Author version unspecified]. Skillstore. https://skillstore.io/skills/internet-court-openserv-agent-sdk/audits/2

Cita BibTeX

@techreport{internet-court-internet-court-openserv-agent-sdk-2026,
  author = {internet-court},
  title = {openserv-agent-sdk security audit report (audit version 2)},
  institution = {Skillstore},
  year = {2026},
  number = {2},
  url = {https://skillstore.io/skills/internet-court-openserv-agent-sdk/audits/2},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "openserv-agent-sdk security audit report (audit version 2)"
version: "unspecified"
type: report
authors:
  - name: "internet-court"
date-released: "2026-07-21"
url: "https://skillstore.io/skills/internet-court-openserv-agent-sdk/audits/2"
identifiers:
  - type: other
    value: "skillstore:internet-court-openserv-agent-sdk:audit:2"
    description: "Skillstore immutable audit report identifier"

Puntuación de Skillstore

Por qué esta puntuación Confianza de la evidencia: Medio

Arquitectura

Mantenibilidad

Contenido

Comunidad

Cumplimiento de la especificación

Lo que puedes crear

Crear un primer agente

Sigue el patrón básico de agentes para aprovisionar y ejecutar un agente de OpenServ con TypeScript.

Desplegar flujos de trabajo en la plataforma

Prepara agentes para activadores webhook, manuales, cron o x402 con la configuración correcta del entorno de ejecución.

Añadir identidad on-chain

Usa la guía de ERC-8004 para registrar la identidad de un agente después del aprovisionamiento.

Prueba estos prompts

Planificar un agente básico

Ayúdame a diseñar un agente sencillo de OpenServ. Incluye el propósito del agente, una capacidad, los paquetes necesarios y los pasos de aprovisionamiento.

Convertir una herramienta en una capacidad

Convierte esta idea de herramienta en una capacidad runnable de OpenServ. Incluye campos de entrada, necesidades de validación, registro de tareas y el resultado esperado.

Depurar errores de aprovisionamiento

Diagnostica este error de inicio de un agente de OpenServ. Explica las causas probables, las comprobaciones de credenciales y los próximos pasos más seguros.

Diseñar un flujo de trabajo para producción

Diseña un flujo de trabajo de OpenServ para producción que incluya despliegue, elección del activador, gestión de credenciales, configuración de tiempos de espera y consideraciones sobre ERC-8004.

Mejores prácticas

Usa capacidades runless o generate cuando las llamadas al modelo delegadas a la plataforma sean suficientes.
Mantén las claves de API de los usuarios, los tokens de autenticación y las claves privadas de las billeteras fuera de los registros y commits.
Llama a provision antes del despliegue y confirma que los tiempos de espera de los activadores se ajusten a las cargas de trabajo previstas.

Evitar

No uses el método heredado process a menos que se requieran llamadas directas a OpenAI.
No reutilices las claves de API de agentes para las llamadas de gestión de PlatformClient.
No borres el estado de la billetera a menos que quieras intencionalmente una nueva identidad on-chain.