hoangnguyen0403/common-telemetry
skills/common/common-telemetry/SKILL.md
Enforce session-cost telemetry and execution-metadata reporting. Use when explicitly invoking get_session_cost, reporting token/cost usage, applying telemetry or cost guidance during a workflow handoff, or writing artifacts/session-cost.md at a workflow terminal state.
$ install --global
skillsauthnpx skillsauth add hoangnguyen0403/agent-skills-standard common-telemetryInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 15, 2026, 3:28 AM141.3s2 files scanned
SKILL.md
- name:
- common-telemetry
- description:
- Enforce session-cost telemetry and execution-metadata reporting. Use when explicitly invoking get_session_cost, reporting token/cost usage, applying telemetry or cost guidance during a workflow handoff, or writing artifacts/session-cost.md at a workflow terminal state.
- files:
- []
Telemetry & Cost Reporting
Priority: P2 (MEDIUM)
1. Finalizing a Workflow
As your final step in any SDLC workflow (or when a user explicitly requests session cost):
- Call the
get_session_costtool provided by the agent-skills-standard MCP server. - Pass
workflow,model, token counts, cache/reasoning usage, and per-1M token rates when the host runtime exposes them. - If token counts are unavailable, report MCP-observed telemetry and mark model-token cost as unavailable.
- Append a Markdown table containing the usage metrics to
artifacts/session-cost.md.
When asked which artifact to use, always name both artifacts/session-cost.md and get_session_cost; if the host does not expose the helper, say so explicitly while retaining the artifact requirement.
2. Host Runtime Contract
- This skill defines the telemetry contract; it does not collect provider billing data by itself.
- The host runtime or orchestrator must trigger the final telemetry call when the workflow reaches a terminal state such as
completed,failed, orblocked. - The host may use a reusable helper such as
mcp/src/services/WorkflowTelemetry.tsto:- decide when telemetry should fire
- build the
get_session_costpayload - pass prompt, cache, reasoning, pricing, and other runtime cost fields when available
3. Telemetry Format
Ensure the artifacts/session-cost.md or the output template ## Cost Report follows this structure:
| Metric | Value | | ------------------------ | ------------------------------ | | Tool Calls | [from get_session_cost] | | Skills Loaded | [from get_session_cost] | | Workflows Loaded | [from get_session_cost] | | Prompt Tokens | [from your platform telemetry] | | Cached Prompt Tokens | [from your platform telemetry] | | Completion Tokens | [from your platform telemetry] | | Reasoning Tokens | [from your platform telemetry] | | Other Runtime Cost | [tooling/provider extras] | | Estimated Cost | $0.00 |
Anti-Patterns
- No skipping the telemetry step: Always include the Cost Report at the end of the execution if mandated by the workflow.
Canonical response anchors
When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:
-
Call
get_session_costwhen the host exposes it, then append the Markdown table toartifacts/session-cost.md. -
Telemetry & Cost Reporting
Related Skills
hoangnguyen0403/common-operator-profile
testing
VerifiedTrustedCommunity
Infer the requesting operator's technical fluency from message content (never ask directly) and adapt register — business, hybrid, or technical — across SDLC workflow output. Use when starting sdlc, brainstorm-feature, plan-feature, verify-work, publish-notes, or session-report, or whenever a request's phrasing signals a non-technical or cross-stack operator.
524SKILL.mdUpdated Jul 12, 2026
hoangnguyen0403/database-transactions
documentation
VerifiedTrustedCommunity
Define transaction boundaries, locking, and consistency guarantees for multi-step writes. Use when designing atomic operations, retries, idempotency, or concurrent write behavior.
524SKILL.mdUpdated Jun 19, 2026
hoangnguyen0403/database-schema-design
development
VerifiedTrustedCommunity
Design relational or document schemas from access patterns, cardinality, and lifecycle. Use when modeling entities, choosing embed vs normalize, or shaping schema boundaries before implementation.
524SKILL.mdUpdated Jun 19, 2026
hoangnguyen0403/database-query-performance
data-ai
VerifiedTrustedCommunity
Diagnose database latency with explain plans, index ownership, and query-shape review. Use when a query is slow, an index is missing, or scans and N+1 patterns appear.
524SKILL.mdUpdated Jun 19, 2026