thoughtleaders-cli 0.7.0__tar.gz → 0.7.1__tar.gz

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tl-cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "ThoughtLeaders CLI — query sponsorship deals, channels, brands, uploads, and intelligence from the terminal",
   "author": {
     "name": "ThoughtLeaders",

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/.gitignore

@@ -6,4 +6,6 @@ dist/
 build/
 .pytest_cache/
 .ruff_cache/
-.vscode/
+.vscode/
+env
+.claude/settings.local.json

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoughtleaders-cli
-Version: 0.7.0
+Version: 0.7.1
 Summary: ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence
 Project-URL: Homepage, https://thoughtleaders.io
 Project-URL: Repository, https://github.com/ThoughtLeaders-io/thoughtleaders-cli

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/agents/youtube-comment-classifier.md

@@ -2,7 +2,7 @@
 name: youtube-comment-classifier
 description: >
   Classifies a batch of YouTube comments as organic vs bot/spam/template for
-  the channel-authenticity skill's fake-engagement detection. Use when you
+  the tl-channel-authenticity skill's fake-engagement detection. Use when you
   have a JSON array of scraped comments and need a fast, cheap per-comment
   authenticity judgment. Returns strict JSON only.
 model: haiku
@@ -14,7 +14,7 @@ color: yellow
 
 You judge whether YouTube comments come from a real, engaged human audience or
 from engagement padding (bots, comment farms, generic filler). You are used by
-the `channel-authenticity` skill to vet channels before ThoughtLeaders books a
+the `tl-channel-authenticity` skill to vet channels before ThoughtLeaders books a
 paid sponsorship, so false "organic" verdicts cost real money — be skeptical.
 
 ## Input

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "thoughtleaders-cli"
-version = "0.7.0"
+version = "0.7.1"
 description = "ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence"
 readme = "README.md"
 license = "MIT"

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/skills/tl/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: tl
+tl-blurb: data analyst (smart query router)
 description: |
   Query and analyze YouTube sponsorship data using the `tl` CLI. Use this skill for finding channels, brands and sponsorships, and for data exploration, including counts, metrics, trends, time-series, distributions, single-record drill-downs, revenue / pipeline-weighting math, view-curve analysis, cross-source business questions. Examples: "How many deals did we close last quarter?", "What's the weighted pipeline by sales owner?", "Show me the view curve for video X", "Find mentions of Surfshark in transcripts", "Investigate this video", "Find channels...", "Find brands...".
 ---

{thoughtleaders_cli-0.7.0/skills/channel-authenticity → thoughtleaders_cli-0.7.1/skills/tl-channel-authenticity}/SKILL.md

@@ -1,5 +1,6 @@
 ---
-name: channel-authenticity
+name: tl-channel-authenticity
+tl-blurb: vet a channel for fake views
 description: >
   Detect non-organic views / fake engagement / bot comments on a YouTube
   channel before booking (or after delivering) a sponsorship. Use when asked
@@ -33,7 +34,7 @@ investigations.
 ## Setup check
 
 ```bash
-cd .claude/skills/channel-authenticity/scripts
+cd .claude/skills/tl-channel-authenticity/scripts
 python3 tl_cli.py preflight        # must print "OK"
 ```
 If this errors with `cli_unavailable`, tell the user to run `tl auth login`

{thoughtleaders_cli-0.7.0/skills/channel-authenticity → thoughtleaders_cli-0.7.1/skills/tl-channel-authenticity}/scripts/_io_utf8.py

@@ -1,4 +1,4 @@
-"""Shared UTF-8 I/O setup for the channel-authenticity scripts.
+"""Shared UTF-8 I/O setup for the tl-channel-authenticity scripts.
 
 YouTube data is full of non-ASCII: channel names, comment text, emoji.
 On POSIX the default I/O encoding is already UTF-8, but on Windows the

{thoughtleaders_cli-0.7.0/skills/channel-authenticity → thoughtleaders_cli-0.7.1/skills/tl-channel-authenticity}/scripts/analyze_channel.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""channel-authenticity orchestrator — two-phase (subagent in the middle).
+"""tl-channel-authenticity orchestrator — two-phase (subagent in the middle).
 
 Phase 1 (collect):
     analyze_channel.py "<ref>"
@@ -128,7 +128,7 @@ def finalize(state_path: str, llm_paths: list[str]) -> dict:
 
 
 def main() -> None:
-    ap = argparse.ArgumentParser(description="channel-authenticity orchestrator")
+    ap = argparse.ArgumentParser(description="tl-channel-authenticity orchestrator")
     ap.add_argument("ref", nargs="?", help="channel handle/url/id or adlink:<id>")
     ap.add_argument(
         "--finalize",

{thoughtleaders_cli-0.7.0/skills/channel-authenticity → thoughtleaders_cli-0.7.1/skills/tl-channel-authenticity}/scripts/report.py

@@ -120,7 +120,7 @@ def render(state: dict) -> str:
     L.append("")
     L.append("---")
     L.append(
-        "_Generated by the `channel-authenticity` skill. Data via the "
+        "_Generated by the `tl-channel-authenticity` skill. Data via the "
         "ThoughtLeaders CLI; comments scraped fresh from YouTube._"
     )
     return "\n".join(L)

{thoughtleaders_cli-0.7.0/skills/channel-authenticity → thoughtleaders_cli-0.7.1/skills/tl-channel-authenticity}/scripts/tl_cli.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Single data-access seam for the channel-authenticity skill.
+"""Single data-access seam for the tl-channel-authenticity skill.
 
 Every TL data getter shells out to the ``tl`` CLI (``tl db pg/fb/es``,
 ``tl channels similar``), so the skill works for anyone with a ThoughtLeaders

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/skills/tl-import/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: tl-import
+tl-blurb: bulk-import lists into a report
 description: Import a list of channels, brands, uploads (videos), or sponsorships into a ThoughtLeaders report — either an existing report (caller supplies `campaign_id` or a TL report URL) or a fresh new one (skill creates a minimal container, then populates). Superuser-only. **Trigger on explicit intent to import the listed entities into a report**, NOT on the mere presence of a list (a user can paste a list and want analysis, comparison, or similar-channel discovery — those go to `tl-cli:tl`). The deciding question is: *would the user be satisfied if those exact entities ended up as the report's contents, no transformation?* If yes, this is the skill. Phrasings: "import these channels into report 1234", "add brands to campaign 5678", "exclude these channels from report Z", "bulk-add these videos to report X", "create a new report with these channels: <list>", "make a campaign containing these brands: <list>".
 ---
 

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/skills/tl-keyword-research/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: tl-keyword-research
+tl-blurb: rank content-search keywords
 description: |
   Broaden and rank a set of content-search keywords. Invoke when the user wants to find videos or channels by content keywords (topics, concepts, niches) — not by ID or exact name. Takes one or more seed keywords (or an NL phrase), proposes related candidates, probes Elasticsearch for each one against the `title` / `summary` / `transcript` fields, and returns a strict JSON object `{"keywords":[{"keyword","count"},...]}` sorted descending by document count. The output is meant to feed the next step (typically a `tl db es` content search with the surviving high-count keywords).
 ---

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/skills/tl-report-builder/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: tl-report-builder
+tl-blurb: build a TL report from scratch
 description: |
   **MANUAL-INVOCATION-ONLY skill — do NOT auto-trigger on natural-language report requests.** This skill is invoked explicitly by the user (via the `/tl-report-builder` slash command, by naming the skill directly, or via some other unambiguous indication). Phrases like "build me a report", "make a campaign", "find me channels with filters Y", or "save this as a report" do NOT route here automatically. Those phrases go to other skills: the `tl` skill (for analysis / exploration of channels / brands / videos / sponsorships), `tl-save-report` (for persisting an in-chat session's result set as a saved report — filter-style or list-style), or `tl-import` (for adding identifiers to an existing report). This skill itself builds a brand-new TL report config from scratch through a heavy four-phase orchestration (routing → schema + validation → columns → widgets), covering the four report types: content/videos (1), brands (2), channels (3), sponsorships/deals (8). Only fire it when the user has explicitly chosen this path — there's almost always a lighter skill that's the right answer.
 

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/skills/tl-save-report/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: tl-save-report
+tl-blurb: save a session as a report
 description: |
   Save the results of an in-chat data-exploration session as a TL report. Triggers when the user wants to persist a channels / brands / videos (uploads) / sponsorships list or filtered set they've been working with — phrases like "save this as a report", "save the list", "turn this into a campaign", "persist this", "make a report from what you found", "save the result", "I want to come back to this".
 ---

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/skills/tl-views-guarantee/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: tl-views-guarantee
+tl-blurb: size a multi-video views guarantee
 description: Calculate the optimal views guarantee (VG) for a multi-video sponsorship buy with a YouTube creator. Given a channel ID or name, returns "video bundle size / views guarantee / likelihood to hit" based on bootstrap simulation of the channel's recent video performance (view counts measured at video age ~30 days). Use when someone asks "what VG should I push for with [creator]", "how many videos should I buy from [creator]", "calculate VG for [channel]", "what's a safe guarantee for [channel]", or anything involving setting views guarantees in a sponsorship deal. Triggers on "VG", "views guarantee", "views minimum", and any request to size a multi-video buy.
 ---
 

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/src/tl_cli/__init__.py

@@ -1,3 +1,3 @@
 """ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence."""
 
-__version__ = "0.7.0"
+__version__ = "0.7.1"

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/src/tl_cli/commands/doctor.py

@@ -68,7 +68,7 @@ _RECOMMENDED_TOOLS: tuple[tuple[str, str, dict[str, str]], ...] = (
     ),
     (
         "yt-dlp",
-        "YouTube metadata/download tool — used by the channel-authenticity skill to fetch video and comment data.",
+        "YouTube metadata/download tool — used by the tl-channel-authenticity skill to fetch video and comment data.",
         {
             "Linux": "pipx install yt-dlp  (or `pip install yt-dlp` / `apt install yt-dlp`)",
             "Darwin": "brew install yt-dlp",

{thoughtleaders_cli-0.7.0 → thoughtleaders_cli-0.7.1}/src/tl_cli/commands/setup.py

@@ -155,6 +155,41 @@ def _install_standalone_skills(plugin_root: Path) -> int:
     return count
 
 
+def _bundled_skill_blurbs(plugin_root: Path) -> list[tuple[str, str]]:
+    """Read (name, tl-blurb) for each bundled skill, for the setup summary.
+
+    Reads the `tl-blurb` frontmatter key from skills/<name>/SKILL.md so the
+    summary stays in sync with the skills actually shipped — no hand-maintained
+    list to drift. Skills without the key are skipped. Sorted by name.
+    """
+    skills_src = plugin_root / "skills"
+    if not skills_src.is_dir():
+        return []
+    blurbs: list[tuple[str, str]] = []
+    for skill_dir in skills_src.iterdir():
+        skill_md = skill_dir / "SKILL.md"
+        if not skill_md.is_file():
+            continue
+        name = blurb = None
+        in_frontmatter = False
+        for line in skill_md.read_text(encoding="utf-8").splitlines():
+            if line.strip() == "---":
+                if in_frontmatter:
+                    break
+                in_frontmatter = True
+                continue
+            if not in_frontmatter:
+                continue
+            if line.startswith("name:"):
+                name = line[len("name:"):].strip()
+            elif line.startswith("tl-blurb:"):
+                blurb = line[len("tl-blurb:"):].strip()
+        if name and blurb:
+            blurbs.append((name, blurb))
+    blurbs.sort(key=lambda nb: nb[0])
+    return blurbs
+
+
 def _print_manual_instructions() -> None:
     """Print manual install instructions when claude binary is not found."""
     console.print()
@@ -264,10 +299,10 @@ def setup_claude(
     console.print("[green]Setup complete![/green]")
     console.print()
     console.print("Available skills in Claude Code:")
-    console.print("  [cyan]/tl[/cyan]                  — data analyst (smart query router)")
-    console.print("  [cyan]/tl-sponsorships[/cyan]     — sponsorship lookup")
-    console.print("  [cyan]/tl-reports[/cyan]          — saved reports")
-    console.print("  [cyan]/tl-balance[/cyan]          — credit balance")
+    blurbs = _bundled_skill_blurbs(plugin_root)
+    width = max((len(name) for name, _ in blurbs), default=0)
+    for name, blurb in blurbs:
+        console.print(f"  [cyan]/{name}[/cyan]{' ' * (width - len(name))}  — {blurb}")
     console.print()
     console.print("Try it:")
     console.print("  [cyan]/tl Which channels did we sponsor in Q1?[/cyan]")

thoughtleaders_cli-0.7.1/tests/test_setup.py

@@ -0,0 +1,41 @@
+"""Tests for `tl setup` helpers."""
+
+from pathlib import Path
+
+from tl_cli.commands.setup import _bundled_skill_blurbs
+
+
+def _write_skill(skills_dir: Path, name: str, body: str) -> None:
+    skill_dir = skills_dir / name
+    skill_dir.mkdir(parents=True)
+    (skill_dir / "SKILL.md").write_text(body, encoding="utf-8")
+
+
+class TestBundledSkillBlurbs:
+    def test_reads_name_and_blurb_sorted(self, tmp_path):
+        skills = tmp_path / "skills"
+        _write_skill(skills, "tl", "---\nname: tl\ntl-blurb: data analyst\ndescription: |\n  Long desc.\n---\n")
+        _write_skill(skills, "alpha", "---\nname: alpha\ntl-blurb: first thing\ndescription: x\n---\n")
+        assert _bundled_skill_blurbs(tmp_path) == [
+            ("alpha", "first thing"),
+            ("tl", "data analyst"),
+        ]
+
+    def test_skips_skill_without_blurb(self, tmp_path):
+        skills = tmp_path / "skills"
+        _write_skill(skills, "tl", "---\nname: tl\ntl-blurb: has one\ndescription: x\n---\n")
+        _write_skill(skills, "other", "---\nname: other\ndescription: no blurb here\n---\n")
+        assert _bundled_skill_blurbs(tmp_path) == [("tl", "has one")]
+
+    def test_ignores_blurb_lookalike_in_body(self, tmp_path):
+        # A `tl-blurb:` line in the markdown body (after frontmatter) must not be picked up.
+        skills = tmp_path / "skills"
+        _write_skill(
+            skills,
+            "tl",
+            "---\nname: tl\ntl-blurb: real blurb\ndescription: x\n---\n\ntl-blurb: not this one\n",
+        )
+        assert _bundled_skill_blurbs(tmp_path) == [("tl", "real blurb")]
+
+    def test_missing_skills_dir_returns_empty(self, tmp_path):
+        assert _bundled_skill_blurbs(tmp_path) == []