Skip to content

v0.1.10 - Skill Files Rewrite

Choose a tag to compare

@vkayatas vkayatas released this 26 Mar 10:34
· 4 commits to master since this release

v0.1.10 - Skill Files Rewrite

Complete rewrite of agent skill files following the Agent Skills specification and best practices.

Problem

Agents ignored bootstrap instructions and ran 5+ pip install attempts before ever trying to use the CLI. They also confused appstore-review-cli with app-store-scraper and other PyPI packages.

What changed

Skill file structure (both copilot.md and claude.md):

  • Opening line now explicitly states "CLI is already installed, do not run pip, do not search PyPI" - the first thing the agent reads before forming its plan
  • Explicitly calls out that this is NOT app-store-scraper or any other package
  • 20-line bootstrap script replaced with 2-line venv activation + verify
  • Rigid NEVER/ALWAYS directives replaced with reasoning-based "Gotchas" section
  • Added compatibility frontmatter field per spec
  • Improved description field with "pre-installed" and broader trigger keywords
  • Reduced from 220/230 lines to 132 lines each (spec recommends <500)
  • Removed Python API section and redundant analysis modes
  • Filter options now in table format for better scannability

New: scripts/run.sh wrapper

  • Bundled executable script per Agent Skills spec pattern
  • Handles venv activation and CLI detection transparently
  • Installed alongside SKILL.md by appstore-reviews setup

Build changes:

  • setup.py now installs scripts/run.sh into skill directories for copilot/claude agents
  • pyproject.toml includes scripts/run.sh in wheel build

Zero pip install commands

There are now exactly zero pip install commands in any code block across all instruction files and scripts. Every mention of "pip" or "install" exists only in the context of "do not do this."