systemlink-cli 1.3.1__tar.gz → 1.4.0__tar.gz

{systemlink_cli-1.3.1 → systemlink_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: systemlink-cli
-Version: 1.3.1
+Version: 1.4.0
 Summary: SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates.
 License-File: LICENSE
 Author: Fred Visser

{systemlink_cli-1.3.1 → systemlink_cli-1.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "systemlink-cli"
-version = "1.3.1"
+version = "1.4.0"
 description = "SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates."
 authors = ["Fred Visser <fred.visser@emerson.com>"]
 packages = [{ include = "slcli" }]

{systemlink_cli-1.3.1 → systemlink_cli-1.4.0}/slcli/_version.py

@@ -1,4 +1,4 @@
 """Version information for slcli."""
 
 # This file is auto-generated. Do not edit manually.
-__version__ = "1.3.1"
+__version__ = "1.4.0"

{systemlink_cli-1.3.1 → systemlink_cli-1.4.0}/slcli/skill_click.py

@@ -13,12 +13,11 @@ from .utils import ExitCodes
 SKILL_NAME = "slcli"
 SKILL_CHOICES = ["slcli", "systemlink-webapp"]
 
-# Mapping of client name → (personal skills dir, project subdir relative to repo root)
+# Mapping of client name -> (personal skills dir, project subdir relative to repo root)
 # personal dir uses Path.home() so it's always resolved at call time via _personal_dir().
 _CLIENT_TABLE: Dict[str, Tuple[str, str]] = {
-    "copilot": ("~/.copilot/skills", ".github/skills"),
+    "agents": ("~/.agents/skills", ".agents/skills"),
     "claude": ("~/.claude/skills", ".claude/skills"),
-    "codex": ("~/.agents/skills", ".agents/skills"),
 }
 
 CLIENT_CHOICES = list(_CLIENT_TABLE.keys())
@@ -84,6 +83,54 @@ def _find_bundled_skills_dir() -> Path:
     )
 
 
+# Universal project-scoped skills directory (client-agnostic)
+PROJECT_SKILLS_SUBDIR = ".agents/skills"
+
+
+def install_skills_to_directory(
+    directory: Path,
+    skill_names: Optional[List[str]] = None,
+    subdir: str = PROJECT_SKILLS_SUBDIR,
+) -> int:
+    """Install bundled skills into a project directory.
+
+    Copies skill folders into a skills subdirectory within *directory*.
+    The default location (``.agents/skills/``) is the universal convention
+    recognized by multiple AI clients.
+
+    Args:
+        directory: Project root to install into.
+        skill_names: Skills to install.  Defaults to all available skills.
+        subdir: Relative subdirectory for skills.  Defaults to ``.agents/skills``.
+
+    Returns:
+        Number of skills successfully installed.
+    """
+    if skill_names is None:
+        skill_names = list(SKILL_CHOICES)
+
+    try:
+        skills_dir = _find_bundled_skills_dir()
+    except FileNotFoundError:
+        return 0
+
+    dest_parent = directory / subdir
+    installed = 0
+
+    for name in skill_names:
+        source = skills_dir / name
+        if not source.exists():
+            continue
+        dest = dest_parent / name
+        dest_parent.mkdir(parents=True, exist_ok=True)
+        if dest.exists():
+            shutil.rmtree(dest)
+        shutil.copytree(source, dest)
+        installed += 1
+
+    return installed
+
+
 def _resolve_destinations(clients: List[str], scope: str) -> List[Path]:
     """Build the list of destination skill parent directories.
 
@@ -123,7 +170,7 @@ def register_skill_commands(cli: Any) -> None:
 
     @cli.group()
     def skill() -> None:
-        """Manage AI agent skills for Copilot, Claude, and Codex."""
+        """Manage AI agent skills for most agents and Claude."""
 
     @skill.command(name="install")
     @click.option(
@@ -136,9 +183,9 @@ def register_skill_commands(cli: Any) -> None:
     @click.option(
         "--client",
         "-c",
-        type=click.Choice(CLIENT_CHOICES + ["all"], case_sensitive=False),
+        type=click.Choice(CLIENT_CHOICES, case_sensitive=False),
         default=None,
-        help="AI client to install for (copilot, claude, codex, or all).",
+        help="AI client to install for (agents [most agents] or claude).",
     )
     @click.option(
         "--scope",
@@ -163,10 +210,10 @@ def register_skill_commands(cli: Any) -> None:
         Available skills: slcli, systemlink-webapp.
         Supported clients and their skill locations:
 
-        \b
-          copilot  personal: ~/.copilot/skills/       project: .github/skills/
-          claude   personal: ~/.claude/skills/         project: .claude/skills/
-          codex    personal: ~/.agents/skills/         project: .agents/skills/
+                    \b
+                agents   personal: ~/.agents/skills/         project: .agents/skills/
+                     (most agents)
+                claude   personal: ~/.claude/skills/         project: .claude/skills/
 
         When options are omitted you will be prompted interactively.
         """
@@ -183,8 +230,11 @@ def register_skill_commands(cli: Any) -> None:
         if client is None:
             client = questionary.select(
                 "Install for which AI client?",
-                choices=CLIENT_CHOICES + ["all"],
-                default="all",
+                choices=[
+                    questionary.Choice("most agents", value="agents"),
+                    questionary.Choice("claude", value="claude"),
+                ],
+                default="agents",
             ).ask()
             if client is None:
                 raise click.Abort()
@@ -200,7 +250,7 @@ def register_skill_commands(cli: Any) -> None:
 
         # ── resolve skill and client lists ────────────────────────────────────
         skill_names: List[str] = SKILL_CHOICES if skill == "all" else [skill]
-        clients: List[str] = CLIENT_CHOICES if client == "all" else [client]
+        clients: List[str] = [client]
 
         # ── locate source ─────────────────────────────────────────────────────
         try:

{systemlink_cli-1.3.1 → systemlink_cli-1.4.0}/slcli/skills/slcli/SKILL.md

@@ -676,7 +676,23 @@ slcli webapp open <WEBAPP_ID>                            # Open webapp URL in br
 
 Templates:
 - `html` (default) — minimal index.html
-- `angular` — Nimble Angular project with PROMPTS.md (AI-ready prompts) and README.md
+- `angular` — Nimble Angular project with `PROMPTS.md`, `README.md`, and bundled AI skills installed into `.agents/skills/`
+
+### skill — AI skill installation
+
+Install bundled skills for supported AI clients.
+
+```bash
+slcli skill install --skill [slcli|systemlink-webapp|all] --client [agents|claude] --scope [personal|project|both]
+```
+
+Client paths:
+- `agents` — personal: `~/.agents/skills/`, project: `.agents/skills/` (most agents)
+- `claude` — personal: `~/.claude/skills/`, project: `.claude/skills/`
+
+Notes:
+- `agents` is the default client in interactive mode.
+- `webapp init --template angular` installs project-scoped skills into `.agents/skills/` by default.
 
 ### example — Built-in example resource provisioning
 

{systemlink_cli-1.3.1 → systemlink_cli-1.4.0}/slcli/webapp_click.py

@@ -17,6 +17,7 @@ import questionary
 import requests
 
 from .cli_utils import validate_output_format
+from .skill_click import install_skills_to_directory
 from .universal_handlers import UniversalResponseHandler
 from .utils import (
     ExitCodes,
@@ -277,63 +278,59 @@ _ANGULAR_PROMPTS_MD = """\
 # SystemLink WebApp — AI Prompts
 
 This project was scaffolded with `slcli webapp init --template angular`.
+The **systemlink-webapp** skill has been installed into this project so
+your AI assistant already knows how to build Nimble Angular apps for
+SystemLink — including component choices, API patterns, routing, theming,
+and deployment. Just describe what you want.
 
-The **systemlink-webapp** skill teaches your AI assistant how to build
-Nimble Angular applications for SystemLink. Install it first:
+## Getting Started
 
-```bash
-slcli skill install --client all
-```
+Open this project in your editor and describe your app:
+
+> "I need a web dashboard for monitoring our production test systems.
+> It should show which systems are online, recent test results, and
+> any assets due for calibration."
 
-## Getting Started Prompts
+Your AI assistant will create the Angular project, install the right
+packages, and build the pages for you.
 
-Copy-paste these into your AI assistant to build out the project:
+## Example Prompts
 
-### 1. Create a basic dashboard layout
+Describe your goals — the skill handles the technical details.
 
-> "Set up the AppModule with NimbleModule imports, a nimble-theme-provider
-> with automatic theme detection, and a nimble-anchor-tabs layout with
-> Overview and Settings tabs. Use hash routing."
+### Fleet monitoring
 
-### 2. Add a systems overview page
+> "Build a dashboard that shows all connected systems with their
+> status, operating system, and last check-in time. Highlight any
+> systems that have been offline for more than 24 hours."
 
-> "Create a SystemsComponent that uses the Systems Management TypeScript
-> client to fetch connected systems and display them in a nimble-table
-> with columns for alias, state, OS, and last-updated timestamp.
-> Add a nimble-spinner while loading."
+### Test results review
 
-### 3. Add a test results page
+> "Create a page where I can browse recent test results, filter by
+> status (passed, failed, running) and program name, and see a
+> summary of failure rates."
 
-> "Create a TestResultsComponent that uses the Test Monitor TypeScript
-> client to list recent test results in a nimble-table. Add
-> nimble-select filters for status (Passed/Failed/Running) and
-> program name. Show a nimble-banner when there are failures."
+### Asset & calibration tracking
 
-### 4. Add an asset calibration tracker
+> "Show all tracked assets grouped by calibration status. I want to
+> see which assets are due soon, which are overdue, and be able to
+> click on an asset to see its full details."
 
-> "Create a CalibrationComponent that uses the Asset Management
-> TypeScript client to show assets grouped by calibration status.
-> Use nimble-card components for each status category with counts.
-> Add a nimble-drawer that shows asset details when clicked."
+### Production KPIs
 
-### 5. Build and deploy
+> "Build a dashboard with key metrics: first-pass yield, test
+> throughput per hour, and a trend chart of failures over the last
+> 30 days."
 
-> "Build the project for production and deploy it to SystemLink
-> using slcli webapp publish."
+### Build and deploy
+
+> "Build the project for production and deploy it to SystemLink."
 
 ## Reference
 
 - [Nimble Angular components](https://nimble.ni.dev/)
 - [SystemLink TypeScript clients](https://www.npmjs.com/package/@ni/systemlink-clients-ts)
 - [slcli webapp commands](https://ni-kismet.github.io/systemlink-cli/commands.html#webapp)
-
-## Build & Deploy
-
-```bash
-ng build --configuration production
-slcli webapp publish dist/<project-name>/browser/ \\
-  --name "My Dashboard" --workspace Default
-```
 """
 
 _ANGULAR_README_MD = """\
@@ -345,39 +342,23 @@ A Nimble Angular web application for SystemLink, scaffolded with
 ## Prerequisites
 
 - [Node.js](https://nodejs.org/) 18+ and npm
-- [Angular CLI](https://angular.dev/tools/cli) (`npm install -g @angular/cli`)
-- [slcli](https://ni-kismet.github.io/systemlink-cli/) with AI skills installed
+- [slcli](https://ni-kismet.github.io/systemlink-cli/)
 
-## Quick Start
+## Getting Started
 
-```bash
-# Install dependencies
-npm install
+Open this directory in your editor and ask your AI assistant to create
+the project — see [PROMPTS.md](PROMPTS.md) for ready-made prompts.
 
-# Start development server
-ng serve --open
-
-# Build for production
-ng build --configuration production
-```
+The AI skills for SystemLink webapp development are already installed
+in this project directory.
 
 ## Deploy to SystemLink
 
 ```bash
+ng build --configuration production
 slcli webapp publish dist/<project-name>/browser/ \\
   --name "My Dashboard" --workspace Default
 ```
-
-## AI-Assisted Development
-
-See [PROMPTS.md](PROMPTS.md) for example prompts to give your AI assistant.
-Install the systemlink-webapp skill first:
-
-```bash
-slcli skill install --client all
-```
-
-Then ask your assistant to build features using the prompts in PROMPTS.md.
 """
 
 
@@ -404,18 +385,19 @@ def _init_angular_template(directory: Path, force: bool) -> None:
     prompts_file.write_text(_ANGULAR_PROMPTS_MD, encoding="utf-8")
     readme_file.write_text(_ANGULAR_README_MD, encoding="utf-8")
 
+    # Auto-install AI skills into the project directory
+    installed = install_skills_to_directory(directory)
+    skill_msg = f"{installed} skill(s) installed" if installed else "skills not found"
+
     format_success(
         "Scaffolded Nimble Angular project",
         {
             "Directory": str(directory),
+            "Skills": skill_msg,
             "Next steps": (
                 "1. cd " + str(directory) + "\n"
-                "   2. ng new <app-name> --no-standalone\n"
-                "   3. cd <app-name>\n"
-                "   4. npm install @ni/nimble-angular "
-                "@ni/systemlink-clients-ts\n"
-                "   5. Install AI skills: slcli skill install --client all\n"
-                "   6. Open PROMPTS.md and start building with AI"
+                "   2. Open in your editor and ask AI to create the app\n"
+                "   3. See PROMPTS.md for example prompts"
             ),
         },
     )