docs: improve skill docs

Author: vitalets

docs/getting-started/agent-skill.md

@@ -1,14 +1,27 @@
 # Agent Skill
 
-Playwright-BDD provides an [agent skill](https://agentskills.io/) that helps AI coding agents generate Gherkin feature files and step definitions. The skill teaches the agent to discover your existing steps via `npx bddgen` and write feature files that reuse them, instead of inventing steps that don't exist.
+?> Agent Skill is a new feature. Your feedback and suggestions are [welcome](https://github.com/vitalets/playwright-bdd/issues).
 
-Install it with a single command:
+Playwright-BDD provides an [agent skill](https://agentskills.io/) that helps AI coding agents generate Gherkin feature files and step definitions, grounded in your actual project steps.
+
+## Supported agents
+
+The skill works with GitHub Copilot, Claude Code, Cursor, Cline, Windsurf, and [many others](https://skills.sh/).
+
+## Installation
+
+Run the following command in your project:
 
 ```
 npx skills add vitalets/playwright-bdd
 ```
 
+## Usage
+
 Once installed, you can ask your AI agent things like:
-- *"Create a feature file for the login flow"*
-- *"Add a scenario for the checkout page"*
-- *"Write BDD tests for the search functionality"*
+- *Create a feature file for the login flow*
+- *Add a scenario for the checkout page*
+- *Write BDD tests for the search functionality*
+
+The agent will inspect your Playwright BDD configuration, list available steps, and produce a `.feature` file that fits your project. If any required steps are missing, it will also suggest their implementations.
+