Agent Skill
2/7/2026

fpf-skilltelemetry-log-work-span

Generates an FPF-compliant OpenTelemetry Span mapped to U.Work.

V
venikman
0GitHub Stars
1Views
npx skills add venikman/fpf-agent-stack

SKILL.md

Namefpf-skilltelemetry-log-work-span
DescriptionGenerates an FPF-compliant OpenTelemetry Span mapped to U.Work.

name: fpf-skill:telemetry-log-work-span description: Generates an FPF-compliant OpenTelemetry Span mapped to U.Work. version: 0.1.0 allowed_tools: []

telemetry/log-work-span Kernel

Context

This skill implements FPF Pattern A.15.1 (U.Work) by mapping execution units to OpenTelemetry Spans. It ensures "Lawful Telemetry" (G.12) by strictly adhering to the 4D Anchor schema.

Instructions

You must generate a valid U.Work record formatted as an OpenTelemetry Span structure.

1. Mandatory 4D Anchors

You must include the following attributes in the span. IF a value is missing, you must either derive it or explicitly label it as UNKNOWN (do not omit).

FPF AnchorOTel AttributeValue Requirement
Specfpf.spec_refURI of the Method being executed (e.g., method:PlanTask@v1).
Performerfpf.performer_refURI of the Role/Agent (e.g., role:Assistant@run-1).
Contextfpf.context_refURI of the Bounded Context (e.g., ctx:AgentFS-Experiment-C1).
Systemfpf.system_refIdentity of the runtime system (e.g., sys:MacBookPro-M3).
Pinsfpf.edition_pinsJSON string of version pins.

2. Metric Telemetry (G.11)

If the work involves derived metrics, include them as attributes:

  • fpf.outcome.class: One of Success, Failure, Aborted.
  • fpf.outcome.rubric_score: (Optional) Integer 1-5.

3. Output Format

Return the JSON representation of the Span, including name, start_time, end_time, and attributes.

Skills Info
Original Name:fpf-skilltelemetry-log-work-spanAuthor:venikman