pm-skills 0.1.0__tar.gz

pm_skills-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Python (helper scripts)
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+
+# OS / editor
+.DS_Store
+*.swp
+.idea/
+.vscode/
+
+# Generated docs catalog (built in CI for Pages)
+web/catalog.html
+web/leaderboard.html
+web/community.html
+web/skill/
+web/sitemap.xml
+web/robots.txt
+
+# vercel-labs `skills` CLI install artifacts (if run inside the repo)
+.agents/
+.claude/skills/
+skills-lock.json
+
+# Generated full eval set (regenerated by scripts/gen-eval-cases.mjs)
+evals/cases.full.json
+
+# Generated agent-discovery files (rebuilt on deploy)
+web/llms.txt
+web/llms-full.txt
+
+# Python build artifacts
+python/dist/
+python/*.egg-info/
+__pycache__/

pm_skills-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: pm-skills
+Version: 0.1.0
+Summary: 205 professional Agent Skills (PRDs, launch plans, postmortems, rubrics, contracts…) as importable building blocks for Python AI agents — LangChain, CrewAI, LlamaIndex, or any framework.
+Project-URL: Homepage, https://github.com/mohitagw15856/pm-claude-skills
+Project-URL: Playground, https://mohitagw15856.github.io/pm-claude-skills/
+Author: Mohit Aggarwal
+License: MIT
+Keywords: agent-skills,ai-agents,crewai,langchain,llm,mcp,prompts
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.40; extra == 'crewai'
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.2; extra == 'langchain'
+Description-Content-Type: text/markdown
+
+# pm-skills (Python)
+
+**205 professional Agent Skills** — PRDs, launch plans, postmortems, rubrics, contracts, pitch
+decks and more, across 21 professions — as importable building blocks for Python AI agents.
+The skills are bundled with the package, so there's **no network call and no API key** to read them.
+
+```bash
+pip install pm-skills                 # core
+pip install "pm-skills[langchain]"    # + LangChain tools
+pip install "pm-skills[crewai]"       # + CrewAI tools
+```
+
+## Core (no dependencies)
+
+```python
+import pm_skills
+
+pm_skills.search_skills("customer churn")          # -> [skill dicts]
+pm_skills.get_skill("prd-template")["description"]  # -> "..."
+pm_skills.bundles()                                  # -> ['pm-creator', 'pm-engineering', ...]
+
+# A ready-to-send prompt for any model:
+prompt = pm_skills.skill_prompt("incident-postmortem", task="API outage, 42 min, bad deploy")
+```
+
+## As LangChain tools
+
+```python
+from langchain.agents import create_react_agent
+from pm_skills import as_langchain_tools
+
+tools = as_langchain_tools()   # [search_pm_skills, get_pm_skill]
+# give `tools` to your agent — it can search the library and pull a skill's framework on demand
+```
+
+## As CrewAI tools
+
+```python
+from crewai import Agent
+from pm_skills import as_crewai_tools
+
+analyst = Agent(role="Product Analyst", tools=as_crewai_tools(), goal="...", backstory="...")
+```
+
+Any other framework works too — `skill_prompt(name, task)` returns plain text you can drop into
+any LLM call. Same skills run live in the [browser playground](https://mohitagw15856.github.io/pm-claude-skills/),
+over [MCP](https://github.com/mohitagw15856/pm-claude-skills/tree/main/mcp), or via `npx pm-claude-skills`.

pm_skills-0.1.0/README.md

@@ -0,0 +1,47 @@
+# pm-skills (Python)
+
+**205 professional Agent Skills** — PRDs, launch plans, postmortems, rubrics, contracts, pitch
+decks and more, across 21 professions — as importable building blocks for Python AI agents.
+The skills are bundled with the package, so there's **no network call and no API key** to read them.
+
+```bash
+pip install pm-skills                 # core
+pip install "pm-skills[langchain]"    # + LangChain tools
+pip install "pm-skills[crewai]"       # + CrewAI tools
+```
+
+## Core (no dependencies)
+
+```python
+import pm_skills
+
+pm_skills.search_skills("customer churn")          # -> [skill dicts]
+pm_skills.get_skill("prd-template")["description"]  # -> "..."
+pm_skills.bundles()                                  # -> ['pm-creator', 'pm-engineering', ...]
+
+# A ready-to-send prompt for any model:
+prompt = pm_skills.skill_prompt("incident-postmortem", task="API outage, 42 min, bad deploy")
+```
+
+## As LangChain tools
+
+```python
+from langchain.agents import create_react_agent
+from pm_skills import as_langchain_tools
+
+tools = as_langchain_tools()   # [search_pm_skills, get_pm_skill]
+# give `tools` to your agent — it can search the library and pull a skill's framework on demand
+```
+
+## As CrewAI tools
+
+```python
+from crewai import Agent
+from pm_skills import as_crewai_tools
+
+analyst = Agent(role="Product Analyst", tools=as_crewai_tools(), goal="...", backstory="...")
+```
+
+Any other framework works too — `skill_prompt(name, task)` returns plain text you can drop into
+any LLM call. Same skills run live in the [browser playground](https://mohitagw15856.github.io/pm-claude-skills/),
+over [MCP](https://github.com/mohitagw15856/pm-claude-skills/tree/main/mcp), or via `npx pm-claude-skills`.

pm_skills-0.1.0/pm_skills/__init__.py

@@ -0,0 +1,109 @@
+"""pm_skills — 205 professional Agent Skills as importable building blocks for Python
+AI agents (LangChain, CrewAI, LlamaIndex, or any framework).
+
+Core helpers have no dependencies:
+
+    import pm_skills
+    pm_skills.search_skills("customer churn")     # -> [skill dicts]
+    pm_skills.get_skill("prd-template")            # -> skill dict
+    pm_skills.skill_prompt("prd-template", task="a referral feature")  # -> ready prompt
+
+Framework adapters lazy-import the framework (install the extra you need):
+
+    from pm_skills import as_langchain_tools, as_crewai_tools
+"""
+from __future__ import annotations
+import json
+from functools import lru_cache
+from importlib import resources
+
+__all__ = [
+    "list_skills", "get_skill", "search_skills", "skill_prompt", "bundles",
+    "as_langchain_tools", "as_crewai_tools", "__version__",
+]
+__version__ = "0.1.0"
+
+
+@lru_cache(maxsize=1)
+def _skills() -> list[dict]:
+    text = resources.files("pm_skills").joinpath("skills.json").read_text(encoding="utf-8")
+    return json.loads(text)["skills"]
+
+
+def list_skills(bundle: str | None = None) -> list[dict]:
+    """All skills, optionally filtered to one bundle (e.g. 'pm-engineering')."""
+    return [s for s in _skills() if bundle is None or s.get("plugin") == bundle]
+
+
+def bundles() -> list[str]:
+    return sorted({s.get("plugin", "other") for s in _skills()})
+
+
+def get_skill(name: str) -> dict:
+    """A skill by exact name. Raises KeyError if not found."""
+    for s in _skills():
+        if s["name"] == name:
+            return s
+    raise KeyError(f"No skill named {name!r}. Try search_skills().")
+
+
+def search_skills(query: str, limit: int = 10) -> list[dict]:
+    """Keyword search over title/description/name, best matches first."""
+    q = query.lower()
+    scored = [(s, (s["title"] + " " + s["description"] + " " + s["name"]).lower().count(q)) for s in _skills()]
+    return [s for s, n in sorted(scored, key=lambda x: -x[1]) if n > 0][:limit]
+
+
+def skill_prompt(name: str, task: str = "") -> str:
+    """The skill's full instructions, ready to send to any model — optionally with a task."""
+    body = get_skill(name)["instructions"]
+    return body + (f"\n\n---\nApply this skill now to the following:\n{task}" if task else "")
+
+
+# ---- framework adapters (lazy imports) -------------------------------------
+def as_langchain_tools():
+    """Two LangChain tools: search_pm_skills(query) and get_pm_skill(name)."""
+    try:
+        from langchain_core.tools import tool
+    except ImportError as e:  # pragma: no cover
+        raise ImportError("Install LangChain: pip install pm-skills[langchain]") from e
+
+    @tool
+    def search_pm_skills(query: str) -> str:
+        """Search 205 professional skills (PRDs, launches, postmortems, rubrics…) by keyword."""
+        hits = search_skills(query, limit=8)
+        return "\n".join(f"- {s['name']}: {s['description']}" for s in hits) or "No matches."
+
+    @tool
+    def get_pm_skill(name: str) -> str:
+        """Get a professional skill's full instructions by name, to apply to the current task."""
+        try:
+            return skill_prompt(name)
+        except KeyError as e:
+            return str(e)
+
+    return [search_pm_skills, get_pm_skill]
+
+
+def as_crewai_tools():
+    """The same two tools as CrewAI BaseTools."""
+    try:
+        from crewai.tools import tool
+    except ImportError as e:  # pragma: no cover
+        raise ImportError("Install CrewAI: pip install pm-skills[crewai]") from e
+
+    @tool("Search PM Skills")
+    def search_pm_skills(query: str) -> str:
+        """Search 205 professional skills by keyword; returns names + descriptions."""
+        hits = search_skills(query, limit=8)
+        return "\n".join(f"- {s['name']}: {s['description']}" for s in hits) or "No matches."
+
+    @tool("Get PM Skill")
+    def get_pm_skill(name: str) -> str:
+        """Get a professional skill's full instructions by name."""
+        try:
+            return skill_prompt(name)
+        except KeyError as e:
+            return str(e)
+
+    return [search_pm_skills, get_pm_skill]