blog-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{blog_cli-0.3.0 → blog_cli-0.4.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: blog-cli
-Version: 0.3.0
-Summary: Agent-friendly CLI for managing a blog. Create drafts, upload media, generate time-limited preview links.
+Version: 0.4.0
+Summary: Agent-friendly CLI for managing a personal site. Articles, projects, categories, private pages, media, and a bundled ChatGPT/Codex skill.
 Author: tanaka-mambinge
 License: MIT
 Project-URL: Repository, https://github.com/tanaka-mambinge/personal-cli
 Project-URL: Issues, https://github.com/tanaka-mambinge/personal-cli/issues
-Keywords: blog,cli,agent,markdown,writing
+Keywords: blog,cli,agent,markdown,writing,mdx,cms,dashboard
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -194,6 +194,57 @@ blog-cli article tag-add my-project --tag python --tag agents
 blog-cli article tag-remove my-project --tag agents
 ```
 
+## Categories
+
+Categories are first-class models that group private content pages. The slug is auto-derived from the name. A category cannot be deleted while pages still belong to it.
+
+```bash
+# Create (slug auto from name, e.g. "YouTube Notes" -> "youtube-notes")
+blog-cli category create --name "Ideas" --icon bulb --description "Captured ideas"
+
+# List / show / update / delete
+blog-cli category list
+blog-cli category show ideas
+blog-cli category update ideas --name "Idea Box" --icon lightbulb
+blog-cli category delete ideas
+```
+
+## Pages
+
+Pages are private content shown only on the dashboard at `/d/<slug>`. They are for your eyes only. Each page belongs to a category and supports MDX with prebuilt components (`<Callout>`, `<Steps>`, `<ImageGrid>`, `<Video>`, `<Figure>`).
+
+```bash
+# Create a page
+blog-cli page create \
+  --title "An idea" \
+  --description "Short summary" \
+  --category ideas \
+  --tag web --tag ai \
+  --markdown-file idea.mdx
+
+# List (optionally filter by category)
+blog-cli page list
+blog-cli page list --category ideas
+
+# Show / update / delete
+blog-cli page show an-idea
+blog-cli page update an-idea --title "A better title"
+blog-cli page update an-idea --markdown-file updated.mdx
+blog-cli page delete an-idea
+```
+
+Page bodies are MDX. Referenced media uses names uploaded via `blog-cli media upload --name <name> <file>`; the site resolves names to media URLs at render time.
+
+## ChatGPT / Codex skill
+
+The CLI ships a bundled `content-pipeline` skill that routes blog, project, and page tasks to the right reference doc. Install it into the user-level skills directory:
+
+```bash
+blog-cli skill install
+blog-cli skill uninstall
+blog-cli skill path
+```
+
 ## Media
 
 Upload media using a stable name, then reference that name from article Markdown:

{blog_cli-0.3.0 → blog_cli-0.4.0}/README.md

@@ -164,6 +164,57 @@ blog-cli article tag-add my-project --tag python --tag agents
 blog-cli article tag-remove my-project --tag agents
 ```
 
+## Categories
+
+Categories are first-class models that group private content pages. The slug is auto-derived from the name. A category cannot be deleted while pages still belong to it.
+
+```bash
+# Create (slug auto from name, e.g. "YouTube Notes" -> "youtube-notes")
+blog-cli category create --name "Ideas" --icon bulb --description "Captured ideas"
+
+# List / show / update / delete
+blog-cli category list
+blog-cli category show ideas
+blog-cli category update ideas --name "Idea Box" --icon lightbulb
+blog-cli category delete ideas
+```
+
+## Pages
+
+Pages are private content shown only on the dashboard at `/d/<slug>`. They are for your eyes only. Each page belongs to a category and supports MDX with prebuilt components (`<Callout>`, `<Steps>`, `<ImageGrid>`, `<Video>`, `<Figure>`).
+
+```bash
+# Create a page
+blog-cli page create \
+  --title "An idea" \
+  --description "Short summary" \
+  --category ideas \
+  --tag web --tag ai \
+  --markdown-file idea.mdx
+
+# List (optionally filter by category)
+blog-cli page list
+blog-cli page list --category ideas
+
+# Show / update / delete
+blog-cli page show an-idea
+blog-cli page update an-idea --title "A better title"
+blog-cli page update an-idea --markdown-file updated.mdx
+blog-cli page delete an-idea
+```
+
+Page bodies are MDX. Referenced media uses names uploaded via `blog-cli media upload --name <name> <file>`; the site resolves names to media URLs at render time.
+
+## ChatGPT / Codex skill
+
+The CLI ships a bundled `content-pipeline` skill that routes blog, project, and page tasks to the right reference doc. Install it into the user-level skills directory:
+
+```bash
+blog-cli skill install
+blog-cli skill uninstall
+blog-cli skill path
+```
+
 ## Media
 
 Upload media using a stable name, then reference that name from article Markdown:

{blog_cli-0.3.0 → blog_cli-0.4.0}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "blog-cli"
-version = "0.3.0"
-description = "Agent-friendly CLI for managing a blog. Create drafts, upload media, generate time-limited preview links."
+version = "0.4.0"
+description = "Agent-friendly CLI for managing a personal site. Articles, projects, categories, private pages, media, and a bundled ChatGPT/Codex skill."
 readme = "README.md"
 requires-python = ">=3.13"
 license = {text = "MIT"}
 authors = [{name = "tanaka-mambinge"}]
-keywords = ["blog", "cli", "agent", "markdown", "writing"]
+keywords = ["blog", "cli", "agent", "markdown", "writing", "mdx", "cms", "dashboard"]
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
@@ -54,6 +54,10 @@ package = true
 
 [tool.setuptools]
 package-dir = {"" = "src"}
+include-package-data = true
 
 [tool.setuptools.packages.find]
 where = ["src"]
+
+[tool.setuptools.package-data]
+personal_cli = ["skill_data/**/*"]

{blog_cli-0.3.0 → blog_cli-0.4.0}/src/blog_cli.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: blog-cli
-Version: 0.3.0
-Summary: Agent-friendly CLI for managing a blog. Create drafts, upload media, generate time-limited preview links.
+Version: 0.4.0
+Summary: Agent-friendly CLI for managing a personal site. Articles, projects, categories, private pages, media, and a bundled ChatGPT/Codex skill.
 Author: tanaka-mambinge
 License: MIT
 Project-URL: Repository, https://github.com/tanaka-mambinge/personal-cli
 Project-URL: Issues, https://github.com/tanaka-mambinge/personal-cli/issues
-Keywords: blog,cli,agent,markdown,writing
+Keywords: blog,cli,agent,markdown,writing,mdx,cms,dashboard
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -194,6 +194,57 @@ blog-cli article tag-add my-project --tag python --tag agents
 blog-cli article tag-remove my-project --tag agents
 ```
 
+## Categories
+
+Categories are first-class models that group private content pages. The slug is auto-derived from the name. A category cannot be deleted while pages still belong to it.
+
+```bash
+# Create (slug auto from name, e.g. "YouTube Notes" -> "youtube-notes")
+blog-cli category create --name "Ideas" --icon bulb --description "Captured ideas"
+
+# List / show / update / delete
+blog-cli category list
+blog-cli category show ideas
+blog-cli category update ideas --name "Idea Box" --icon lightbulb
+blog-cli category delete ideas
+```
+
+## Pages
+
+Pages are private content shown only on the dashboard at `/d/<slug>`. They are for your eyes only. Each page belongs to a category and supports MDX with prebuilt components (`<Callout>`, `<Steps>`, `<ImageGrid>`, `<Video>`, `<Figure>`).
+
+```bash
+# Create a page
+blog-cli page create \
+  --title "An idea" \
+  --description "Short summary" \
+  --category ideas \
+  --tag web --tag ai \
+  --markdown-file idea.mdx
+
+# List (optionally filter by category)
+blog-cli page list
+blog-cli page list --category ideas
+
+# Show / update / delete
+blog-cli page show an-idea
+blog-cli page update an-idea --title "A better title"
+blog-cli page update an-idea --markdown-file updated.mdx
+blog-cli page delete an-idea
+```
+
+Page bodies are MDX. Referenced media uses names uploaded via `blog-cli media upload --name <name> <file>`; the site resolves names to media URLs at render time.
+
+## ChatGPT / Codex skill
+
+The CLI ships a bundled `content-pipeline` skill that routes blog, project, and page tasks to the right reference doc. Install it into the user-level skills directory:
+
+```bash
+blog-cli skill install
+blog-cli skill uninstall
+blog-cli skill path
+```
+
 ## Media
 
 Upload media using a stable name, then reference that name from article Markdown:

{blog_cli-0.3.0 → blog_cli-0.4.0}/src/blog_cli.egg-info/SOURCES.txt

@@ -13,5 +13,12 @@ src/personal_cli/client.py
 src/personal_cli/credentials.py
 src/personal_cli/formatting.py
 src/personal_cli/setup_server.py
+src/personal_cli/skill.py
+src/personal_cli/skill_data/SKILL.md
+src/personal_cli/skill_data/agents/openai.yaml
+src/personal_cli/skill_data/references/articles.md
+src/personal_cli/skill_data/references/pages.md
+src/personal_cli/skill_data/references/projects.md
 tests/test_cli.py
-tests/test_client.py
+tests/test_client.py
+tests/test_pages_categories.py

{blog_cli-0.3.0 → blog_cli-0.4.0}/src/personal_cli/cli.py

@@ -22,12 +22,18 @@ blog_app = typer.Typer(help="Manage blog posts.")
 project_app = typer.Typer(help="Manage projects.")
 media_app = typer.Typer(help="Manage media uploads.")
 keys_app = typer.Typer(help="Manage stored credentials.")
+category_app = typer.Typer(help="Manage content categories.")
+page_app = typer.Typer(help="Manage private content pages.")
+skill_app = typer.Typer(help="Manage the bundled ChatGPT/Codex skill.")
 
 app.add_typer(article_app, name="article")
 article_app.add_typer(blog_app, name="blog")
 article_app.add_typer(project_app, name="project")
 app.add_typer(media_app, name="media")
 app.add_typer(keys_app, name="keys")
+app.add_typer(category_app, name="category")
+app.add_typer(page_app, name="page")
+app.add_typer(skill_app, name="skill")
 
 Result = TypeVar("Result")
 
@@ -55,6 +61,19 @@ def build_client(
     return ArticleApiClient(server_url or url, api_key=api_key, verify=not insecure)
 
 
+def _site_url() -> str:
+    _, _, site_url = get_config()
+    return site_url.rstrip("/")
+
+
+def _dashboard_url(slug: str) -> str:
+    return f"{_site_url()}/d/{slug}"
+
+
+def _category_dashboard_url(slug: str) -> str:
+    return f"{_site_url()}/d?category={slug}"
+
+
 def run(coro):
     return asyncio.run(coro)
 
@@ -164,7 +183,7 @@ def project_create(
     description: str = typer.Option(..., "--description", help="Short summary."),
     slug: str | None = typer.Option(None, "--slug", help="Optional slug override."),
     tag: list[str] = typer.Option([], "--tag", help="Repeat for each tag."),
-    cover_image: str | None = typer.Option(None, "--cover-image", help="Uploaded media name for the project banner image."),
+    cover_image: str = typer.Option(..., "--cover-image", help="Uploaded media name for the project banner image."),
     status: str = typer.Option("draft", "--status", help="draft or published."),
     pinned: bool = typer.Option(False, "--pinned/--not-pinned", help="Pin to the home page."),
     sort_order: int = typer.Option(0, "--sort-order", help="Order among pinned projects (lower first)."),
@@ -221,6 +240,16 @@ def article_update(
         if cover_image is not None and clear_cover_image:
             raise CLIError("Use either --cover-image or --clear-cover-image, not both.")
         client = build_client(server_url, insecure=insecure)
+        current = next(
+            (article for article in run(client.list_articles(type_filter="all")) if article.get("slug") == slug),
+            None,
+        )
+        if current is None:
+            raise CLIError(f"Article not found: {slug}")
+        target_type = article_type or current.get("type")
+        resulting_cover = cover_image if cover_image is not None else current.get("cover_image")
+        if target_type == "project" and (clear_cover_image or not resulting_cover):
+            raise CLIError("Projects must have a cover image. Use --cover-image or keep the existing cover image.")
         payload: dict[str, object] = {}
         if title is not None:
             payload["title"] = title
@@ -511,6 +540,327 @@ def keys_show(
         raise typer.Exit(code=1) from exc
 
 
+# ---------------------------------------------------------------------------
+# Categories
+# ---------------------------------------------------------------------------
+
+
+@category_app.command("create")
+def category_create(
+    name: str = typer.Option(..., "--name", help="Display name. Slug is derived from this."),
+    icon: str | None = typer.Option(None, "--icon", help="Tabler icon name, e.g. bulb."),
+    description: str | None = typer.Option(None, "--description", help="Short description."),
+    sort_order: int = typer.Option(0, "--sort-order", help="Lower sorts first."),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        payload: dict[str, object] = {"name": name, "sort_order": sort_order}
+        if icon is not None:
+            payload["icon"] = icon
+        if description is not None:
+            payload["description"] = description
+        result = run(client.create_category(payload))
+        result["dashboard_url"] = _category_dashboard_url(result["slug"])
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@category_app.command("list")
+def category_list(
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.list_categories())
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@category_app.command("show")
+def category_show(
+    slug: str,
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.get_category(slug))
+        result["dashboard_url"] = _category_dashboard_url(result["slug"])
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@category_app.command("update")
+def category_update(
+    slug: str,
+    name: str | None = typer.Option(None, "--name", help="New display name."),
+    icon: str | None = typer.Option(None, "--icon", help="New tabler icon name."),
+    description: str | None = typer.Option(None, "--description", help="New description."),
+    sort_order: int | None = typer.Option(None, "--sort-order", help="Lower sorts first."),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        payload: dict[str, object] = {}
+        if name is not None:
+            payload["name"] = name
+        if icon is not None:
+            payload["icon"] = icon
+        if description is not None:
+            payload["description"] = description
+        if sort_order is not None:
+            payload["sort_order"] = sort_order
+        if not payload:
+            raise CLIError("No update fields provided.")
+        result = run(client.update_category(slug, payload))
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@category_app.command("delete")
+def category_delete(
+    slug: str,
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.delete_category(slug))
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+# ---------------------------------------------------------------------------
+# Pages
+# ---------------------------------------------------------------------------
+
+
+@page_app.command("create")
+def page_create(
+    title: str = typer.Option(..., "--title", help="Page title."),
+    description: str = typer.Option(..., "--description", help="Short summary."),
+    category: str = typer.Option(..., "--category", help="Category slug the page belongs to."),
+    slug: str | None = typer.Option(None, "--slug", help="Optional slug override."),
+    sort_order: int = typer.Option(0, "--sort-order", help="Lower sorts first."),
+    markdown: str | None = typer.Option(None, "--markdown", help="Inline MDX body."),
+    markdown_file: Path | None = typer.Option(None, "--markdown-file", exists=True, readable=True, dir_okay=False),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        body = read_markdown_from_source(markdown=markdown, markdown_file=markdown_file)
+        client = build_client(server_url, insecure=insecure)
+        payload = {
+            "title": title,
+            "description": description,
+            "category_slug": category,
+            "slug": slug,
+            "sort_order": sort_order,
+            "markdown": body,
+        }
+        result = run(client.create_page(payload))
+        result["dashboard_url"] = _dashboard_url(result["slug"])
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@page_app.command("list")
+def page_list(
+    category: str | None = typer.Option(None, "--category", help="Filter by category slug."),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.list_pages(category=category))
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@page_app.command("show")
+def page_show(
+    slug: str,
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.get_page(slug))
+        result["dashboard_url"] = _dashboard_url(result["slug"])
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@page_app.command("update")
+def page_update(
+    slug: str,
+    title: str | None = typer.Option(None, "--title", help="New title."),
+    description: str | None = typer.Option(None, "--description", help="New summary."),
+    category: str | None = typer.Option(None, "--category", help="New category slug."),
+    sort_order: int | None = typer.Option(None, "--sort-order", help="Lower sorts first."),
+    markdown: str | None = typer.Option(None, "--markdown", help="Inline MDX body."),
+    markdown_file: Path | None = typer.Option(None, "--markdown-file", exists=True, readable=True, dir_okay=False),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        payload: dict[str, object] = {}
+        if title is not None:
+            payload["title"] = title
+        if description is not None:
+            payload["description"] = description
+        if category is not None:
+            payload["category_slug"] = category
+        if sort_order is not None:
+            payload["sort_order"] = sort_order
+        if markdown is not None or markdown_file is not None:
+            payload["markdown"] = read_markdown_from_source(markdown=markdown, markdown_file=markdown_file)
+        if not payload:
+            raise CLIError("No update fields provided.")
+        result = run(client.update_page(slug, payload))
+        result["dashboard_url"] = _dashboard_url(result["slug"])
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@page_app.command("delete")
+def page_delete(
+    slug: str,
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+    insecure: bool = typer.Option(False, "--insecure", help="Skip SSL verification."),
+    server_url: str | None = typer.Option(None, "--server-url", help="FastAPI base URL."),
+) -> None:
+    def _op() -> None:
+        client = build_client(server_url, insecure=insecure)
+        result = run(client.delete_page(slug))
+        emit_result(result, json_output=json_output)
+
+    try:
+        _run(_op)
+    except CLIError as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+# ---------------------------------------------------------------------------
+# Skill installation
+# ---------------------------------------------------------------------------
+
+
+@skill_app.command("install")
+def skill_install(
+    target_dir: Path | None = typer.Option(
+        None,
+        "--dir",
+        help="Destination directory. Defaults to ~/.agents/skills/content-pipeline.",
+    ),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+) -> None:
+    """Install the bundled ChatGPT/Codex skill into the agents skills directory."""
+    from personal_cli.skill import install_skill
+
+    try:
+        destination = install_skill(target_dir)
+        emit_result(
+            {"installed": True, "path": str(destination)},
+            json_output=json_output,
+        )
+    except Exception as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@skill_app.command("uninstall")
+def skill_uninstall(
+    target_dir: Path | None = typer.Option(
+        None,
+        "--dir",
+        help="Installed location. Defaults to ~/.agents/skills/content-pipeline.",
+    ),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+) -> None:
+    """Remove the installed skill."""
+    from personal_cli.skill import uninstall_skill
+
+    try:
+        removed = uninstall_skill(target_dir)
+        emit_result({"uninstalled": removed}, json_output=json_output)
+    except Exception as exc:
+        typer.echo(str(exc), err=True)
+        raise typer.Exit(code=1) from exc
+
+
+@skill_app.command("path")
+def skill_path(
+    target_dir: Path | None = typer.Option(None, "--dir", help="Custom install location."),
+    json_output: bool = typer.Option(False, "--json", help="Emit JSON output."),
+) -> None:
+    """Print where the skill would be installed."""
+    from personal_cli.skill import skill_install_path
+
+    destination = skill_install_path(target_dir)
+    emit_result({"path": str(destination)}, json_output=json_output)
+
+
 def main() -> None:
     app()