機能的なプログラミングの規準の代理店の技術を維持して下さい。

日本語版 README

機能的スキルは、工学的方法論です。複雑なスキルのメンテナンスと反復のために設計。 トレースロギングとユニットテストと組み合わせることで、スキルモジュラー、トレース可能、テスト可能:

• 各[[Step]をFunction]]として明示[Input/Output]を扱います。(最初に純粋な関数)
• [[SKILL.md]のみFunctionのパイプラインをオーケストレーションし、[external inputsのみを消費]とreference dependencies]
• [Functionを渡る共有ルールは[references/]に移動します
• [Functionで呼ばれる決定的な論理は[scripts/になります
• ローカルで実行されるすべての[[Function]のためのトレースのロギングを加えて下さい、入出力/トークン消費/durationを記録して下さい
• ユニットテストとE2Eテストですべての[[Functionを装備し、個々の機能も完全にパイプラインの回帰を保証する

クイックスタート

インストール

Skill.sh でインストールします。 -a を 1 つのエージェントをターゲットに、グローバル インストールをサポートする場合にのみ [-g] を追加します。

お問い合わせ

使用法

Create — ワークフローの簡単な新しい機能スキル:

Migrate — 既存のレガシー・スキル・ディレクトリを機能的なスキルに変換:

マイグレートレーンは、スキルパッケージ全体を読み取ります.

Functional Skill Creator

Maintain Agent Skills with functional programming discipline.

中文版 README

Functional Skill is an engineering methodology, designed for complex Skill maintenance and iteration. Combined with trace logging and unit testing, it makes Skills modular, traceable, and testable:

• Treat each Step as a Function with explicit Input/Output (pure function first)
• SKILL.md only orchestrates the pipeline of Functions, consuming only external inputs and reference dependencies
• Shared rules across Functions go into references/
• Deterministic logic called by Functions becomes scripts/
• Add trace logging for every Function, running locally, recording input/output/token consumption/duration
• Equip every Function with unit tests and E2E tests, ensuring neither individual Functions nor the full pipeline regress

Quick Start

Install

npx skills add AGI-comming/functional-skill-creator --skill fskill-creator -y

Install via skills.sh. Add -a to target one agent; add -g only if it supports global install.

---

Usage

Create — new functional skill from a workflow brief:

/fskill-creator create a functional skill for 

Migrate — convert an existing legacy skill directory into a functional skill:

/fskill-creator migrate 

The migrate lane reads the whole skill package — SKILL.md, references/, scripts/, and other companion files — not a single markdown file in isolation.

Optional: include_report, include_unittest, include_viewers (on by default; set to false to skip).

Why

Your Skill is getting bloated.

As your Skill’s capabilities iterate, your SKILL.md and references/*.md grow longer, rules pile up, edge cases get patched ever more finely — slowly turning into an unmaintainable wall of prose.

A typical example is when everything keeps getting stuffed into a handful of markdown files:

Before: monolithic prose wall

flowchart TB
  subgraph mono["Monolithic Skill — tangled dependencies"]
    SKILL["SKILL.mdGoal · Workflow · Rules · Output · Known issues"]
    W["Workflow + Step 1.5 patch"]
    RL["Rules · edge cases · stop rules"]
    OUT["Output handler · validation"]

    RULES["references/rules.mdTerms · policies · snippets"]
    EX["references/examples.mdSuccess · failures · workarounds"]

    S1["parse_input.js"]
    S2["parse_input_new.js"]
    S3["fix_edge_case_once.sh"]
    S4["migrate_old_do_not_delete.js"]
  end

  SKILL  W
  SKILL  RL
  W  RL
  RL  OUT
  SKILL  RULES
  RULES  EX
  EX  W
  OUT  EX
  W --> S1
  RL --> S2
  S1  S2
  S2 --> S3
  S3  EX
  OUT --> S4
  S4  SKILL
  S3  RL
  S1 --> OUT

  style mono fill:#fff5f5,stroke:#c53030
  style SKILL fill:#fde8e8,stroke:#c53030
  style W fill:#fde8e8,stroke:#c53030