> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Practitioner Skills

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">Need help?</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>Ask in Discord</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>Open a GitHub issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>Support guide</span>
    </a>
  </div>
</div>

This directory collects Codex-compatible skills that are useful for everyday
workflows and personal operations. Each skill should be usable as an
installable package with a human-facing `README.md`, an agent-facing
`SKILL.md`, and only the supporting resources it needs.

## Current Skills

| Skill                             | Package path                                                                                                                                                                | What it demonstrates                                                                                                                                                         |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent Runtime Cache Benchmark     | [`skills/agent-runtime-cache-benchmark/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/agent-runtime-cache-benchmark/README.md)         | Local-first comparison of cold and warm agent runs, cache-break detection from structured run artifacts, and report-driven prompt-cache tuning                               |
| Daily News Watcher                | [`skills/daily-news-watcher/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/daily-news-watcher/README.md)                               | SQLite-backed persistent news monitoring, RSS/Atom + optional Playwright fetching, URL+hash deduplication, and per-run Markdown reports                                      |
| Garbage Collector                 | [`skills/garbage-collector/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/garbage-collector/README.md)                                 | Preview-first local cleanup, readable CSV rules, reversible duplicate cleanup, and explicit approval before destructive actions                                              |
| Local Document Organizer          | [`skills/local-document-organizer/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/local-document-organizer/README.md)                   | Preview-first folder organization, readable classification rules with confidence scoring, reversible moves with action logs, and a no-delete, no-overwrite safety contract   |
| Personal Knowledge Capture        | [`skills/personal-knowledge-capture/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/personal-knowledge-capture/README.md)               | Local-first watch-path registration, incremental source detection, SQLite state, and cited Markdown note generation                                                          |
| Prompt Cache Agent Harness        | [`skills/prompt-cache-agent-harness/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/prompt-cache-agent-harness/README.md)               | Claude prompt-cache layer planning, captured usage metadata review, cache-read/write reporting, and optional caller-supplied input-cost estimates                            |
| Prompthon Social Campaign Manager | [`skills/prompthon-social-campaign-manager/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/prompthon-social-campaign-manager/README.md) | Production social operations through a signed-in browser handoff, local companion bridge token exchange, org-scoped API mutations, media attachment, and scheduling readback |
| Safety Escalation Review          | [`skills/safety-escalation-review/README.md`](https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/skills/safety-escalation-review/README.md)                   | Local evidence review, redacted escalation memos, and human-owned safety handoff checklists without external reporting                                                       |

## Skill Package Shape

Each shared skill should keep the package itself small:

```text theme={null}
skills/<skill-name>/
  README.md
  SKILL.md
  agents/openai.yaml
  scripts/
  references/
```

Use `README.md` for the human-facing story: why the package exists, who it is
for, and the end-to-end workflow a student or operator should understand before
using it. Use `SKILL.md` for the Codex invocation contract. Use `scripts/` for
deterministic helpers, `references/` for rule files or supporting guidance, and
`agents/openai.yaml` for UI metadata.

## Contribution Type

Practitioner skill packages are code-plus-docs contributions. A package should
include a human-facing `README.md`, an agent-facing `SKILL.md`, agent metadata,
deterministic scripts, reference rules, and the minimum supporting
documentation needed to make the skill reviewable and runnable. Do not treat
these issues as documentation-only unless the requested change only edits
explanatory pages.

## Contribution Type

Practitioner skill packages are code-plus-docs contributions. A package can
include Markdown instructions, agent metadata, deterministic scripts, reference
rules, and the minimum supporting documentation needed to make the skill
reviewable and runnable. Do not treat these issues as documentation-only unless
the requested change only edits explanatory pages.

## Practitioner Boundary

Practitioner skills should show where Codex execution is stronger than a plain
chat answer: local files, persistent rules, repeatable workflows, browser or
system interaction, and explicit safety checks.