Skip to content

[refactoring] Extract reporting + OTLP dual import into shared/reporting-otlp.md bundle #26624

@github-actions

Description

@github-actions

Skill Overview

A significant number of workflows import both shared/reporting.md (report formatting guidelines) and shared/observability-otlp.md (OTLP telemetry endpoint config) without the full daily-audit-discussion stack. These two imports form a natural pairing — any workflow that publishes reports and needs telemetry observability uses both. A combined shared/reporting-otlp.md bundle would reduce this to a single import line.

Current Usage

21 confirmed workflows import both shared/reporting.md + shared/observability-otlp.md WITHOUT using shared/daily-audit-discussion.md:

  • daily-architecture-diagram.md (lines: - shared/reporting.md + - shared/observability-otlp.md)
  • daily-cli-performance.md
  • daily-cli-tools-tester.md
  • daily-doc-healer.md
  • daily-function-namer.md
  • daily-malicious-code-scan.md
  • daily-mcp-concurrency-analysis.md
  • daily-multi-device-docs-tester.md
  • daily-news.md
  • daily-otel-instrumentation-advisor.md
  • daily-rendering-scripts-verifier.md
  • daily-repo-chronicle.md
  • daily-safe-output-integrator.md
  • daily-safe-output-optimizer.md
  • daily-safe-outputs-conformance.md
  • daily-security-red-team.md
  • daily-syntax-error-quality.md
  • daily-team-status.md
  • smoke-codex.md
  • smoke-copilot-arm.md
  • smoke-gemini.md

Proposed Shared Component

File: .github/workflows/shared/reporting-otlp.md

---
# Reporting + OTLP bundle
# Combines report formatting guidelines with OTLP observability configuration.
# Use this for workflows that publish reports/PRs/issues with telemetry observability.
#
# Usage:
#   imports:
#     - shared/reporting-otlp.md

imports:
  - shared/reporting.md
  - shared/observability-otlp.md
---

Usage Example (before):

imports:
  - shared/reporting.md
  - shared/observability-otlp.md

Usage Example (after):

imports:
  - shared/reporting-otlp.md

Impact

  • Workflows affected: 21 workflows confirmed; potentially more as new workflows are added
  • Lines saved: 21 × 2 = ~42 import lines
  • Maintenance benefit: New observability features or report format changes propagate to all 21 workflows at once
  • Discoverability: New workflow authors find one obvious import instead of needing to remember both components

Implementation Plan

  1. Create .github/workflows/shared/reporting-otlp.md as a bundle importing both components
  2. Update daily-architecture-diagram.md as the pilot workflow (simplest case, 2 imports → 1)
  3. Run make recompile to verify lock file output is identical
  4. Migrate remaining 20 workflows in a single PR
  5. Update documentation/examples to recommend reporting-otlp.md as the default for analysis workflows
  6. Consider extending to daily-audit-base.md (see related issue) for the daily-audit-discussion stack

Related Analysis

This recommendation comes from the Workflow Skill Extractor analysis run on 2026-04-16.

Quantitative Impact Summary:

Metric Value
Confirmed workflows 21
Import lines eliminated ~42
Components bundled 2 (reporting.md + observability-otlp.md)
Complexity Low (no parameterization needed)

Generated by Workflow Skill Extractor · ● 5M ·

  • expires on Apr 18, 2026, 11:48 AM UTC

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions