Skip to content

Create, Evaluate, and Connect AI Skills

docs: streamline search result guidance in SDK README

Icarus-Chend7586c12a797
diff --git a/skillnet-ai/README.md b/skillnet-ai/README.md
index deec285..d17aa20 100644
--- a/skillnet-ai/README.md
+++ b/skillnet-ai/README.md
@@ -133,26 +133,13 @@ for skill in results:
print(skill.skill_name, skill.stars, skill.skill_url)
```
-**Names and sources.** `skill_name` is not unique: different repositories or version
-directories can contain skills with the same name. `stars` is the source repository's
-star count at collection time, not a rating of the individual skill.
+Each result includes the repository (`repo_name`), source directory (`skill_dir`,
+including the repository prefix), and download URL (`skill_url`). Different
+repositories or version directories may share a skill name. `stars` records the
+repository's star count at collection time.
-With skillnet-ai 0.1.3+, search records also expose nullable source fields:
-
-| Field | Meaning | Example |
-| :-- | :-- | :-- |
-| `repo_name` | Source repository | `owner/repository` |
-| `skill_dir` | Source directory, including the repository prefix | `owner/repository/releases/v2/skills/example` |
-
-The CLI shows the repository and directory below each skill name; `--json` preserves
-the full fields. Missing metadata is `null` (`None` in Python), including responses
-from older servers. Older SDK releases ignore these fields; upgrade with
-`pip install -U skillnet-ai` to read them in Python or CLI output.
-
-Use `skill_url` to distinguish returned source links and download the selected entry.
-For grouping a collected source directory, use `skill_dir` when available. A directory
-can receive content updates, and its commit-specific `skill_url` can change; neither
-the name nor name plus repository uniquely identifies all source directories.
+The CLI displays the repository and directory below each skill name; `--json`
+includes both fields. Source metadata is `None` when unavailable.
<details>
<summary><b>Search parameters</b></summary>