Skip to main content

forge-skills

Skills Runtime for the Forge agent harness.

Provides intent-based skill dispatch, SKILL.md loading, and sub-run execution with full EventBus integration.

Installation

pip install forge-skills
# With intent-based dispatch (sentence-transformers):
pip install forge-skills[intent]

Quick start

from forge_skills import SkillDef, SkillRuntime

rt = SkillRuntime()

skill = SkillDef(
    name="greet",
    description="Greet a user by name",
    examples=["say hello to", "greet", "hi to"],
    parameters=[{"name": "user", "type": "string", "description": "User name"}],
)

async def greet_handler(args: dict) -> str:
    return f"Hello, {args['user']}!"

rt.register(skill, handler=greet_handler)

result = await rt.invoke("greet", arguments={"user": "Alice"})
print(result.output)  # Hello, Alice!

SKILL.md format

---
name: summarize
description: Summarize a document
examples:
  - "summarize this"
  - "give me the key points"
parameters:
  - name: text
    type: string
    description: Text to summarize
    required: true
timeout_seconds: 30.0
tags:
  - nlp
---

Summarize the following text concisely:

{text}

Technical debt

See DEVLOG.md for DT entries introduced in Phase 3.

Metadata

Release files for forge-skills 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for forge-skills 0.2.0
File Size Uploaded
forge_skills-0.2.0.tar.gz 14.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for forge-skills 0.2.0
File Interpreter ABI Platform
forge_skills-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 27.1 kB

Release files / forge_skills-0.2.0.tar.gz

Download URL forge_skills-0.2.0.tar.gz
Size 14.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b06fc6e036529c52d99b1542022e989697ecd77488a6f8e369055b36f167fce3
BLAKE2b-256 checksum
How to use checksums
d64d12ea0563fa4b664c5f43a6d84c7177cecc372c15906aa7c4782bced8a028
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / forge_skills-0.2.0-py3-none-any.whl

Download URL forge_skills-0.2.0-py3-none-any.whl
Size 12.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
890d8be4c5bed4e401d37d7ac9918d397e8dfcafb7fd7da78d0fa138c4f7dd62
BLAKE2b-256 checksum
How to use checksums
d2d450aa5fd35771c7489ce3c1e003c97cdb5523622596cb0a968dc8e65b2fca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page