{
  "markdown": "# Oya Plugin\n\nOya is a planning companion for intentional weekly and daily planning. It is packaged here as a Cowork- and Claude-compatible plugin bundle with a plugin manifest and the `oya` skill assets.\n\n## What It Does\n\nOya helps users:\n\n- plan the week with a short, structured review\n- create daily focus lists from weekly priorities\n- carry unfinished tasks forward until they are complete\n- optionally use coaching, values, and nudges to stay aligned\n\n## Package Contents\n\n```text\noya-plugin/\n├── .claude-plugin/\n│   └── plugin.json\n└── skills/\n    └── oya/\n        ├── SKILL.md\n        ├── assets/\n        └── references/\n```\n\n## Installation\n\n### Option 1: Install from source\n\n1. Clone this repository.\n2. Keep the `oya-plugin` directory intact so the manifest and skill files stay together.\n3. Install or copy the package using your Claude plugin loading workflow.\n\n### Option 2: Install as a released bundle\n\n1. Download the packaged `oya-plugin` release archive.\n2. Extract it without changing the internal folder structure.\n3. Install the extracted folder using your Cowork or Claude plugin loading workflow.\n\n### Skill-only fallback\n\nIf you are loading Claude skills directly instead of using a plugin bundle, copy `skills/oya` into your local `.claude/skills/` directory.\n\n## Usage\n\nRun `oya` in Claude after installation.\n\nOn first run, Oya will:\n\n1. create a weekly note\n2. ask the user to personalize the planning setup\n3. create a daily entry from the weekly plan\n\nAfter onboarding, Oya switches to a fast regular flow:\n\n- create the current weekly note if it is missing\n- append today's daily entry if needed\n- carry forward unfinished tasks\n- optionally provide critique and coaching\n\n## Configuration\n\nOya stores user-specific settings in `.claude/oya.md` inside the user's working directory.\n\nCommon settings include:\n\n- name\n- mantra\n- planning contexts\n- values\n- nudges\n- coaching preferences\n- optional custom note paths\n\nSee `skills/oya/references/config-guide.md` for the full configuration reference.\n\n## Versioning\n\nThis plugin uses semantic versioning.\n\n- `MAJOR`: incompatible workflow or packaging changes\n- `MINOR`: backward-compatible features or expanded planning behavior\n- `PATCH`: backward-compatible fixes, copy updates, or packaging corrections\n\nThe current manifest version is `0.1.0`, which marks this package as an early distributable release.\n\n## Cowork Packaging\n\nCowork validates the plugin manifest and the archive layout.\n\n- package the contents of the plugin root, not a parent `oya-plugin/` folder\n- keep `.claude-plugin/plugin.json` at the archive root\n- prefer a `.plugin` archive for distribution\n\nExample:\n\n```bash\ncd ~/code/oss/oya-plugin\nzip -r /tmp/oya-plugin.plugin . -x \"*.DS_Store\" -x \"*.git*\"\n```\n\n## Distribution\n\nUse the files in this folder as the source of truth for distribution.\n\n- keep `.claude-plugin/plugin.json` and `skills/oya/` in the same package\n- publish packaged archives from the plugin root\n- document changes for each release\n- test with a small team before promoting the release broadly\n\nSee `PUBLISHING.md` for the release checklist.\n\n## Privacy Policy\n\nIf you need a public privacy policy URL for plugin submission, publish `docs/privacy.md` with GitHub Pages from this repository.\n\nThe GitHub Pages landing page can be served from `docs/index.md`.\n",
  "bytes": 3335,
  "sha": "6dcabc1e1651e0525e7053c7648829fe3e42b84d6ae0f3ce9fd5c507fd9a392a",
  "repo_slug": "foogunlana/oya-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_foogunlana_oya_plugin_oya_2879c7f8/readme"
}