feat(spotify): implement milestone M1 scaffold

docs/README.md

@@ -10,6 +10,7 @@ This folder contains detailed docs for each skill in this repository.
 - [`portainer`](portainer.md) — Portainer stack management (list, lifecycle, updates, image pruning)
 - [`property-assessor`](property-assessor.md) — Residential property assessment with CAD/public-record enrichment, Zillow/HAR photo review, valuation workflow, and PDF delivery rules
 - [`searxng`](searxng.md) — Privacy-respecting metasearch via a local or self-hosted SearXNG instance
+- [`spotify`](spotify.md) — Spotify Web API helper for track search, playlist management, and text/M3U/folder imports
 - [`us-cpa`](us-cpa.md) — Federal individual 1040 workflow for tax questions, case intake, preparation, review, and draft e-file-ready export
 - [`web-automation`](web-automation.md) — One-shot extraction plus CloakBrowser automation, including unit-aware Zillow/HAR discovery and dedicated photo extraction
 

docs/spotify.md

@@ -0,0 +1,18 @@
+# Spotify
+
+The Spotify skill adds a local helper for Spotify Web API work from OpenClaw.
+
+Current scope:
+
+- search Spotify tracks
+- list the current user's playlists
+- create private or public playlists
+- add and remove track URIs
+- search and add tracks
+- import tracks from text lists, M3U/M3U8 playlists, and local folders
+
+The skill uses OAuth2 Authorization Code with PKCE. It does not need a Spotify client secret and does not use browser automation for Spotify operations.
+
+Implementation is in `skills/spotify/`.
+
+Setup and live-smoke details will be completed with the auth and command implementation.