lfenghx/skill_agent

技能特工

作者： lfenghx 版本： 0.0.3 类型： 工具（插件）

引言

Skill Agent 是一个基于“Skill Progressive Disclosure”的通用工具插件。它将本地的 skills/ 目录视为工具箱，因此模型可以按需阅读技能手册，然后仅在必要时读取文件/运行脚本，最后传递文本或文件。

使用场景

• 你想整合技能，并用“手动（SKILL.md）+文件结构+脚本”来约束/强化模型。
• 你需要进度信息，并返回生成文件作为工具输出
• 你希望将能力打包为可重复使用的技能文件夹（参考文档、脚本等），而不是把所有内容硬编码在提示词中

特色

• 渐进披露：技能索引→读取SKILL.md→根据需要读取文件/执行命令
• 文件传递：代理完成后，临时会话目录中的所有文件返回
• 自由执行：代理可以执行诸如读写文件和运行脚本等命令
• 可控内存：可配置的内存转数和最大步进深度

工具参数

该插件提供两个工具：

Skill Agent

Author: lfenghx
Version: 0.0.3
Type: Tool (Plugin)

Introduction

Skill Agent is a general-purpose tool plugin based on “Skill Progressive Disclosure”. It treats the local skills/ directory as a toolbox, so the model can read the skill manual on demand, then read files / run scripts only when necessary, and finally deliver text or files.

Use Cases

• You want to integrate Skills and constrain/strengthen the model using “manual (SKILL.md) + file structure + scripts”
• You want progress messages and to return generated files as tool outputs
• You want to package capabilities as reusable skill folders (Reference, Scripts, etc.) instead of hard-coding everything in prompts

Features

• Progressive disclosure: skill index → read SKILL.md → read files / run commands as needed
• File delivery: all files in the temp session directory are returned when the agent finishes
• Free execution: the agent can execute commands such as reading/writing files and running scripts
• Controllable memory: configurable memory turns and max step depth

Tool Parameters

This plugin provides two tools:

• “Skill Manager”: manages the local skills directory (list/add/delete skills)
• “agent_skill”: a general agent that can execute skills that have been stored

How to Use (in Dify)

Step 1: Install this plugin directly from the Marketplace
Step 2: For self-hosted deployments, set Files_url in Dify’s .env to your Dify address, otherwise Dify cannot fetch uploaded files
Step 3: Build your workflow as shown below

Step 4: Manage skills

Step 5: Chat with Skill Agent

Video tutorial: https://www.bilibili.com/video/BV1iszkBCEes

Skill Standard

• Every skill must include SKILL.md (YAML frontmatter supported: name, description)
• SKILL.md can define trigger conditions, workflow, required reference reads, commands to run, and deliverable specs

Changelog

• 0.0.3:
  1. Support agent streaming output
  2. Support interactive, multi-turn conversations across turns
  3. Support file memory (no need to re-upload repeatedly)
  4. Support running Node.js scripts as skills
  5. Improve skill_agent runtime stability
• 0.0.2: Support agent file upload and parsing; support automatic dependency installation
• 0.0.1: Implement skill management and a general agent that works with progressive disclosure

FAQ

1. Installation issues
   If installation fails with network access available, try switching Dify’s pip mirror for better dependency download performance. In intranet environments, install via an offline package (contact the author).

2. File transfer issues