@olegkoval/agent-skills 1.0.0-beta.1

package/packages/software-development/changelog-generator/adapters/cursor/skills/changelog-generator/SKILL.md

@@ -0,0 +1,113 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+name: changelog-generator
+description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+compatibility: Codex, Claude Code, Cursor, and other Agent Skills compatible tools. Requires git history access in the target repository.
+metadata:
+  author: Oleg Koval
+  tags:
+    - changelog
+    - release-notes
+    - git
+    - docs
+---
+
+# Changelog Generator
+
+This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
+
+## When to Use This Skill
+
+- Preparing release notes for a new version
+- Creating weekly or monthly product update summaries
+- Documenting changes for customers
+- Writing changelog entries for app store submissions
+- Generating update notifications
+- Creating internal release documentation
+- Maintaining a public changelog/product updates page
+
+## What This Skill Does
+
+1. **Scans Git History**: Analyzes commits from a specific time period or between versions
+2. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
+3. **Translates Technical → User-Friendly**: Converts developer commits into customer language
+4. **Formats Professionally**: Creates clean, structured changelog entries
+5. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.)
+6. **Follows Best Practices**: Applies changelog guidelines and your brand voice
+
+## How to Use
+
+### Basic Usage
+
+From your project repository:
+
+```
+Create a changelog from commits since last release
+```
+
+```
+Generate changelog for all commits from the past week
+```
+
+```
+Create release notes for version 2.5.0
+```
+
+### With Specific Date Range
+
+```
+Create a changelog for all commits between March 1 and March 15
+```
+
+### With Custom Guidelines
+
+```
+Create a changelog for commits since v2.4.0, using my changelog 
+guidelines from CHANGELOG_STYLE.md
+```
+
+## Example
+
+**User**: "Create a changelog for commits from the past 7 days"
+
+**Output**:
+```markdown
+# Updates - Week of March 10, 2024
+
+## ✨ New Features
+
+- **Team Workspaces**: Create separate workspaces for different 
+  projects. Invite team members and keep everything organized.
+
+- **Keyboard Shortcuts**: Press ? to see all available shortcuts. 
+  Navigate faster without touching your mouse.
+
+## 🔧 Improvements
+
+- **Faster Sync**: Files now sync 2x faster across devices
+- **Better Search**: Search now includes file contents, not just titles
+
+## 🐛 Fixes
+
+- Fixed issue where large images wouldn't upload
+- Resolved timezone confusion in scheduled posts
+- Corrected notification badge count
+```
+
+**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter
+
+## Tips
+
+- Run from your git repository root
+- Specify date ranges for focused changelogs
+- Use your CHANGELOG_STYLE.md for consistent formatting
+- Review and adjust the generated changelog before publishing
+- Save output directly to CHANGELOG.md
+
+## Related Use Cases
+
+- Creating GitHub release notes
+- Writing app store update descriptions
+- Generating email updates for users
+- Creating social media announcement posts

package/packages/software-development/docs-index-keeper/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: docs-index-keeper
+description: Keep a repository's Markdown docs index in sync by installing and running docs-index-keeper in pre-commit hooks, CI, or one-off maintenance flows.
+license: MIT
+compatibility: Codex, Claude Code, Cursor, and other Agent Skills compatible tools. Requires shell access and Node.js 18+ when installing from npm.
+metadata:
+  author: Oleg Koval
+  package: docs-index-keeper
+  tags:
+    - docs
+    - markdown
+    - documentation
+    - pre-commit
+    - ci
+    - index
+---
+
+# docs-index-keeper
+
+Use this skill when a repository keeps docs under `docs/` and needs a Markdown index table updated automatically as docs are added or changed.
+
+## Trigger phrases
+
+- keep a docs index up to date
+- auto-update `docs/README.md`
+- add a pre-commit hook for docs indexing
+- enforce docs index freshness in CI
+- add a specific `docs/*.md` file into a Markdown index table
+
+## Workflow
+
+1. Confirm the repo has a docs directory and an index table such as `| Doc | Purpose |`.
+2. Install the package if it is not already present:
+
+```bash
+npm install -D docs-index-keeper
+```
+
+3. Initialize the hook:
+
+```bash
+npx docs-index-keeper init
+```
+
+4. For CI enforcement, run:
+
+```bash
+npx docs-index-keeper check
+```
+
+5. For one-off staged maintenance, run:
+
+```bash
+npx docs-index-keeper update
+```
+
+## Notes
+
+- `update` operates on staged Markdown files.
+- `check` exits non-zero when the index is missing entries for staged docs.
+- Purpose text comes from the first Markdown heading when available.
+- New rows are inserted before an archive sentinel row when present.

package/packages/software-development/docs-index-keeper/adapters/claude/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "olko:docs-index-keeper",
+  "description": "Keep Markdown docs indexes in sync through hooks, CI, or one-off maintenance.",
+  "skills": [
+    {
+      "name": "olko:docs-index-keeper",
+      "source": "../../SKILL.md"
+    }
+  ]
+}

package/packages/software-development/docs-index-keeper/adapters/codex/README.md

@@ -0,0 +1,5 @@
+# Codex adapter
+
+Use the canonical skill directly from `packages/software-development/docs-index-keeper/SKILL.md`.
+
+Optional repo-local guidance can live in `AGENTS.md` for repositories that need stronger operating instructions.

package/packages/software-development/docs-index-keeper/adapters/cursor/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:docs-index-keeper",
+  "version": "0.1.0",
+  "description": "Keep Markdown docs indexes in sync with staged docs changes using a portable skill and npm CLI.",
+  "skills": "skills/"
+}

package/packages/software-development/docs-index-keeper/adapters/cursor/skills/docs-index-keeper/SKILL.md

@@ -0,0 +1,64 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+name: docs-index-keeper
+description: Keep a repository's Markdown docs index in sync by installing and running docs-index-keeper in pre-commit hooks, CI, or one-off maintenance flows.
+license: MIT
+compatibility: Codex, Claude Code, Cursor, and other Agent Skills compatible tools. Requires shell access and Node.js 18+ when installing from npm.
+metadata:
+  author: Oleg Koval
+  package: docs-index-keeper
+  tags:
+    - docs
+    - markdown
+    - documentation
+    - pre-commit
+    - ci
+    - index
+---
+
+# docs-index-keeper
+
+Use this skill when a repository keeps docs under `docs/` and needs a Markdown index table updated automatically as docs are added or changed.
+
+## Trigger phrases
+
+- keep a docs index up to date
+- auto-update `docs/README.md`
+- add a pre-commit hook for docs indexing
+- enforce docs index freshness in CI
+- add a specific `docs/*.md` file into a Markdown index table
+
+## Workflow
+
+1. Confirm the repo has a docs directory and an index table such as `| Doc | Purpose |`.
+2. Install the package if it is not already present:
+
+```bash
+npm install -D docs-index-keeper
+```
+
+3. Initialize the hook:
+
+```bash
+npx docs-index-keeper init
+```
+
+4. For CI enforcement, run:
+
+```bash
+npx docs-index-keeper check
+```
+
+5. For one-off staged maintenance, run:
+
+```bash
+npx docs-index-keeper update
+```
+
+## Notes
+
+- `update` operates on staged Markdown files.
+- `check` exits non-zero when the index is missing entries for staged docs.
+- Purpose text comes from the first Markdown heading when available.
+- New rows are inserted before an archive sentinel row when present.