Agent skill

Writing Reports

by Netflix-Skunkworks in Netflix-Skunkworks/oci-agent

Invoke this skill when writing oci-report.md from an executed OCI analysis.

Apache-2.0Auto-check passed

Install Writing Reports

skills CLI
$ npx skills add Netflix-Skunkworks/oci-agent --skill writing-reports -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Netflix-Skunkworks/oci-agent writing-reports --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Netflix-Skunkworks/oci-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/writing-reports .claude/skills/writing-reports && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
writing-reports
GitHub stars
144
Token cost
~832 tokens
SKILL.md length
393 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

Invoke this skill when writing oci-report.md from an executed OCI analysis.

  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Writing Reports is an agent skill from Netflix-Skunkworks/oci-agent. Invoke this skill when writing oci-report.md from an executed OCI analysis. Keywords: - oci-report.md, actor-critic report - results.json, analysis spec, analysis plan - diagnostics: covariate balance, overlap, placebo outcome - SMD, P1 confounders, propensity scores - ATE, ATT, ATO estimands - decision-grade results, diagnostic table

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is Apache-2.0.

Example prompts

  • “/writing-reports”

What it can do on your machine

Read from SKILL.md and the folder at commit a978030. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Writing Reports loads about 832 tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 393 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~832

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Netflix-Skunkworks/oci-agent at commit a978030, republished under its Apache-2.0 licence (© Netflix-Skunkworks). 393 words, ~832 tokens.

Download SKILL.mdSave it as .claude/skills/writing-reports/SKILL.md (or your agent's skills folder).
name
writing-reports
description
Invoke this skill when writing oci-report.md from an executed OCI analysis. Keywords: - oci-report.md, actor-critic report - results.json, analysis spec, analysis plan - diagnostics: covariate balance, overlap, placebo outcome - SMD, P1 confounders, propensity scores - ATE, ATT, ATO estimands - decision-grade results, diagnostic table
  • Review only the analysis plan, spec, and results.json. Do not use ground truth when reviewing evals.
  • Keep reports short.

Interpreting the plan

  • Plan rules scoped to a specific iteration (e.g. "for the first iteration", "for iter_01") bind only that iteration. They are starting conditions for the actor-critic loop, not invariants.
  • When reviewing iter_NN with NN > 1, do not flag deviations from first-iteration defaults as compliance issues. Subsequent iterations are graded against (a) results-vs-spec consistency, (b) the diagnostic rules below, and (c) iteration-agnostic plan rules only.
  • Iteration-agnostic plan rules (no iteration-scoping phrase) bind every iteration.
  • Plan instructions about how to revise on later iterations (e.g. "if diagnostics fail for the ATO, rerun with a higher ATO_THRESHOLD") describe legitimate revisions — do not flag them as deviations.

Fail conditions

  • The parameterization in results.json does not match the spec.
  • results.json includes no estimands.
  • An estimand is missing its estimate, standard error, or 95% confidence interval.

Diagnostics

  • Covariate balance: max standardized mean difference (SMD) of P1 confounders must be < 0.2. Otherwise fail.
  • Overlap: warn if more than 10% of observations have propensity scores outside (0.1, 0.9).
  • Placebo outcome: warn if the treatment effect on the placebo is significant (p < 0.05).

Report structure

  • Executive summary: treatment, outcome, dataset, P1 confounders, estimand(s), estimate(s), confidence interval(s).
  • Diagnostic table and whether the results are satisfactory.
  • Next steps: remedies for failed diagnostics and warnings, unobserved confounders, confirmatory experiments.

Diagnostic table columns

  • Estimand: ATE, ATT, or ATO (diagnostics are per-estimand — one row per estimand × diagnostic).
  • Diagnostic: Covariate Balance, Overlap, Placebo Outcome.
  • Target Result: Max P1 SMD < 0.2, < 10% extreme propensities, no significant effect.
  • Actual Result.
  • Grade: ✅ Pass, ⛔ Fail, ⚠️ Warning. ⛔ is reserved exclusively for Max P1 SMD > 0.2 (covariate balance) — it is the only blocking failure. Overlap and placebo can only be ✅ or ⚠️ — never ⛔.
Show full SKILL.md (101 more words)Show less

Satisfaction (three tiers)

  • Decide one of three labels for the overall analysis and report it in the executive summary:

    • fully_satisfactory — every diagnostic is ✅. Results are decision-grade as-is.
    • satisfactory_with_caveats — no ⛔, but at least one ⚠️ (overlap and/or placebo). Results are usable but the caveats must be called out, and remedies should still be suggested.
    • not_satisfactory — at least one ⛔ (covariate balance failure). Results are blocked from decision use until the balance failure is remedied.
  • The covariate-balance check is the only blocking failure. Overlap and placebo warnings degrade results to "with caveats" but never block.

  • If any diagnostic fails or warns, invoke the suggesting-remedies skill.

© Netflix-Skunkworks, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/writing-reports of Netflix-Skunkworks/oci-agent.

Open the folder on GitHubat commit a978030

Compare with similar skills

Writing Reports next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Writing Reports compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Reports this skillNetflix-Skunkworks/oci-agent144—~832Automated safety check: PassApache-2.0
Ocioracle/skills877—~2.4kAutomated safety check: PassUPL-1.0
Create Invoke TaskDataDog/datadog-agent3.8k—~606Automated safety check: NotesApache-2.0
Golem Invoke Agent Moonbitgolemcloud/golem1.5k—~1.4kAutomated safety check: PassCustom licence
Golem Invoke Agent Rustgolemcloud/golem1.5k—~1.4kAutomated safety check: PassCustom licence
Golem Invoke Agent Scalagolemcloud/golem1.5k—~1.4kAutomated safety check: PassCustom licence

Similar skills

  • Oci

    oracle/skills

    Official

    Oracle Cloud Infrastructure guidance for designing, operating, and troubleshooting OCI services, including OCI Kubernetes Engine (OKE), OCI Internet of Things Platform, OCI Functions deployment and…

    877 GitHub stars~2.4k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Create Invoke Task

    DataDog/datadog-agent

    Official

    Create a new Python invoke task for the dda CLI. An agent skill from DataDog/datadog-agent.

    3.8k GitHub stars~606 tokensUpdated yesterday
    Auto-check: notes
  • Invoking a MoonBit Golem agent method from the CLI. An agent skill from golemcloud/golem.

    1.5k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Golem Invoke Agent Rust

    golemcloud/golem

    Invoking a Rust Golem agent method from the CLI. An agent skill from golemcloud/golem.

    1.5k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Golem Invoke Agent Scala

    golemcloud/golem

    Invoking a Scala Golem agent method from the CLI. An agent skill from golemcloud/golem.

    1.5k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Golem Invoke Agent TS

    golemcloud/golem

    Invoking a TypeScript Golem agent method from the CLI. An agent skill from golemcloud/golem.

    1.5k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

More from Netflix-Skunkworks/oci-agent

  • Changing Notebooks

    Netflix-Skunkworks/oci-agent

    Invoke this skill when making any modification to a notebook (.ipynb) in the OCI agent.

    144 GitHub stars~484 tokensUpdated 1 mo ago
    Auto-check passed
  • Suggesting Remedies

    Netflix-Skunkworks/oci-agent

    Invoke this skill when an OCI diagnostic fails or warns and a spec change is needed.

    144 GitHub stars~916 tokensUpdated 1 mo ago
    Auto-check passed
  • Writing Specs

    Netflix-Skunkworks/oci-agent

    Invoke this skill when initiating an OCI analysis from a plan or user prompt — i.e.

    144 GitHub stars~364 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Writing Reports

What does Writing Reports do?

Invoke this skill when writing oci-report.md from an executed OCI analysis. Writing Reports is an agent skill from Netflix-Skunkworks/oci-agent.md from an executed OCI analysis.

How do I install Writing Reports in Claude Code?

Run `npx skills add Netflix-Skunkworks/oci-agent --skill writing-reports -a claude-code`. Or copy the skill folder (skills/writing-reports in Netflix-Skunkworks/oci-agent) into .claude/skills/writing-reports in your project. Claude Code loads it when a task matches its description.

How do I install Writing Reports in Codex?

Run `npx skills add Netflix-Skunkworks/oci-agent --skill writing-reports -a codex`. Or copy the skill folder (skills/writing-reports in Netflix-Skunkworks/oci-agent) into .agents/skills/writing-reports in your project. Codex loads it when a task matches its description.

Can I use Writing Reports in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Netflix-Skunkworks/oci-agent --skill writing-reports -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-reports, .gemini/skills/writing-reports, .github/skills/writing-reports and .opencode/skills/writing-reports in your project.

What does Writing Reports need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing Reports is instructions for the agent only.

Does Writing Reports access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Writing Reports safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Writing Reports use?

Writing Reports is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Writing Reports use?

About 832 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Writing Reports?

Skills that share tags, products or a category with Writing Reports: Oci (oracle/skills, 877 stars), Create Invoke Task (DataDog/datadog-agent, 3.8k stars), Golem Invoke Agent Moonbit (golemcloud/golem, 1.5k stars) and Golem Invoke Agent Rust (golemcloud/golem, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Reports?

Netflix-Skunkworks (a GitHub organization) maintains it in Netflix-Skunkworks/oci-agent, which has 144 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 15, 2026.

Source: Netflix-Skunkworks/oci-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.