WeKnora/examples/skills
lyingbug d5cb842580
feat(agent): unify sandbox tools and drop host preloaded skills (#3033)
* feat(agent): unify sandbox tools and drop host preloaded skills

Read workspace and skill files through read_file, and run installed or staged skills through shell_exec(skill_name). Remove the unused skills/preloaded tree and keep generated-file previews stable across re-renders.

* fix(frontend): do not assume classList in markdown sanitize hooks

Node unit tests stub anchors without a DOM classList. Detect download cards from class/download attributes instead.
2026-09-05 16:45:59 +08:00
..
pdf-processing feat: support agent skills 2026-02-04 20:08:49 +08:00
README.md feat(agent): unify sandbox tools and drop host preloaded skills (#3033) 2026-09-05 16:45:59 +08:00

README.md

Skills 示例

本目录包含 Agent Skills 功能的示例。

目录结构

skills/
├── README.md              # 本文件
└── pdf-processing/        # PDF 处理技能示例
    ├── SKILL.md           # 主文件(Level 2)
    ├── FORMS.md           # 补充文档(Level 3)
    └── scripts/           # 可执行脚本
        ├── analyze_form.py
        └── extract_text.py

快速开始

运行 Demo

go run ./cmd/skills-demo/main.go

创建新 Skill

  1. 在本目录创建新文件夹:
mkdir my-new-skill
  1. 创建 SKILL.md:
---
name: my-new-skill
description: Description of what this skill does and when to use it.
---

# My New Skill

Instructions for the agent...
  1. 添加脚本(可选):
mkdir my-new-skill/scripts
# 添加你的脚本

详细文档

完整文档请参阅:Agent Skills 文档

示例:pdf-processing

这是一个功能完整的示例技能,展示了:

  • SKILL.md: 包含 YAML frontmatter 的主文件
  • FORMS.md: 补充参考文档
  • scripts/: 可在沙箱中执行的 Python 脚本

技能描述

name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents.

包含的脚本

脚本 功能
analyze_form.py 分析 PDF 表单字段
extract_text.py 从 PDF 提取文本

使用示例

Agent 会根据用户请求自动调用:

用户: "分析一下这个 PDF 表单有哪些字段"

Agent: 
  1. 识别匹配 pdf-processing 技能
  2. 调用 read_file(path="skill://pdf-processing/SKILL.md") 加载技能内容
  3. 调用 shell_exec(skill_name="pdf-processing", command=...) 执行 analyze_form.py
  4. 返回表单字段分析结果