@thierryteisseire/leadgenius-skill 1.0.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LeadGenius Pro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# LeadGenius Pro Agent API Skill
+
+A specialized skill for AI agents to interact with the LeadGenius Pro B2B platform. This skill enables agents to manage ABM campaigns, enrich leads, and automate outreach workflows.
+
+## 🚀 Installation
+
+Add this skill to your agent environment:
+
+```bash
+npx skills add https://github.com/thierryteisseire/leadgenius-skill
+```
+
+## 🛠️ Features
+
+- **Lead Lifecycle**: List, create, and transition lead statuses.
+- **AI Enrichment**: Trigger automated data augmentation for person and company data.
+- **Campaign Management**: Handle ABM targets and monitor ROI metrics.
+- **Analytics**: Pull pipeline performance and conversion trends.
+- **Integrations**: Sync data with CRMs and configure webhooks.
+
+## 📂 Repository Structure
+
+- `SKILL.md`: Core instructions for AI agents.
+- `references/`: Detailed documentation.
+  - `api_reference.md`: Human-readable endpoint documentation.
+  - `openapi.json`: Machine-readable specification.
+- `scripts/`: Helper utilities.
+  - `api_call.py`: CLI tool for testing API requests.
+
+## 🔑 Requirements
+
+To use this skill, you need a LeadGenius Pro API Key.
+- Base URL: `/api/agent`
+- Headers: `X-API-Key: lgp_your_key`
+
+## ⚖️ License
+MIT License. See [LICENSE.txt](LICENSE.txt) for details.

package/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: leadgenius-api
+description: Comprehensive toolset for interacting with LeadGenius Pro Agent APIs. Use for managing ABM campaigns, lead lifecycle, AI enrichment, target accounts, outreach sequences, and system integrations. Supports listing, creating, and updating resources via the LeadGenius RESTful API.
+---
+
+# LeadGenius Pro Agent API
+
+This skill provides a comprehensive interface for interacting with the LeadGenius Pro Agent API.
+
+## Core Workflows
+
+### 1. Lead Management
+- **Find Leads**: Use `GET /leads` to list contacts.
+- **Enrich Leads**: Use `POST /enrichment/trigger` to start AI augmentation.
+- **Update Status**: Use `PUT /leads/{id}/status` to track progress (New -> Qualified -> Contacted).
+
+### 2. Campaign Operations
+- **Overview**: List all active ABM campaigns with `GET /campaigns`.
+- **Performance**: Monitor ROI with `GET /campaigns/{id}/metrics`.
+- **Creation**: Launch new initiatives with `POST /campaigns`.
+
+### 3. Targeted ABM
+- **Account Lists**: Manage high-value targets with `GET /target-accounts`.
+- **Scoring**: Update account intent and fit scores with `PUT /target-accounts/{id}/score`.
+
+## Technical Reference
+
+### Base URL
+All requests are relative to: `/api/agent` (e.g. `https://your-domain.com/api/agent/leads`)
+
+### Authentication
+Include your API key in the headers:
+```http
+X-API-Key: lgp_your_secret_key
+# OR
+Authorization: Bearer lgp_your_secret_key
+```
+
+### Reference Material
+- **OpenAPI Spec**: See [openapi.json](references/openapi.json) for a full list of endpoints, parameters, and schemas.
+- **Documentation**: A detailed HTML guide is available at `/api/agent/docs`.
+
+### Helper Scripts
+Use [scripts/api_call.py](scripts/api_call.py) to make authenticated requests from the command line.
+
+## Guardrails
+- **Rate Limits**: Default limit is 60 requests per minute.
+- **Batching**: Limit batch lead creation to 100 per request.
+- **Permissions**: Ensure your API key has the required scope (Read/Write/Admin).

package/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "@thierryteisseire/leadgenius-skill",
+    "version": "1.0.0",
+    "description": "LeadGenius Pro Agent API Skill for AI agents",
+    "main": "SKILL.md",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/thierryteisseire/leadgenius-skill.git"
+    },
+    "keywords": [
+        "agent-skill",
+        "leadgenius",
+        "ai-agent",
+        "abm",
+        "lead-generation"
+    ],
+    "author": "Thierry Teisseire",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/thierryteisseire/leadgenius-skill/issues"
+    },
+    "homepage": "https://github.com/thierryteisseire/leadgenius-skill#readme",
+    "files": [
+        "SKILL.md",
+        "references/",
+        "scripts/",
+        "LICENSE.txt",
+        "README.md"
+    ]
+}

package/references/api_reference.md

@@ -0,0 +1,97 @@
+# LeadGenius Pro Agent API Reference
+
+This document provides a detailed breakdown of all available endpoints in the LeadGenius Pro Agent API.
+
+## Base URL
+`https://your-domain.com/api/agent`
+
+## Authentication
+All requests require an API key passed in headers:
+- `X-API-Key: lgp_...`
+- OR `Authorization: Bearer lgp_...`
+
+---
+
+## 📊 Campaigns
+Manage ABM campaigns and track performance.
+
+### `GET /campaigns`
+List all campaigns.
+- **Query Params**: `page`, `pageSize`, `status`, `campaignType`.
+
+### `POST /campaigns`
+Create a new campaign.
+- **Body**: `{ name, description, campaignType, startDate, endDate, goals: { targetAccounts, targetEngagement, targetPipeline } }`
+
+### `GET /campaigns/{id}`
+Retrieve campaign details.
+
+### `GET /campaigns/{id}/metrics`
+Get real-time performance metrics (ROI, conversion rates, etc.).
+
+---
+
+## 👤 Leads
+Lifecycle management for marketing and sales leads.
+
+### `GET /leads`
+List leads with advanced filtering.
+- **Filters**: `status`, `campaignId`, `email`, `companyName`.
+
+### `POST /leads`
+Create a single lead.
+
+### `POST /leads/batch`
+Create up to 100 leads in a single request.
+- **Body**: `{ leads: [...] }`
+
+### `PUT /leads/{id}/status`
+Transition a lead status (e.g., `new` -> `qualified`).
+
+---
+
+## ✨ Enrichment
+Trigger AI-powered data augmentation.
+
+### `POST /enrichment/trigger`
+Queue enrichment for specific lead IDs.
+- **Body**: `{ leadIds: [], enrichmentType, priority }`
+
+### `GET /enrichment/status/{jobId}`
+Check the progress of an enrichment job.
+
+### `GET /enrichment/services`
+List all available third-party and AI enrichment services.
+
+---
+
+## 🏢 Target Accounts (ABM)
+### `GET /target-accounts`
+List high-value target accounts.
+
+### `PUT /target-accounts/{id}/score`
+Update account intent, engagement, and fit scores.
+
+---
+
+## 📈 Analytics
+### `GET /analytics/pipeline`
+Overall funnel performance metrics.
+
+### `GET /analytics/trends`
+Historical conversion trends.
+
+### `POST /analytics/reports`
+Request a custom data export.
+
+---
+
+## ⚙️ Workflows & Integrations
+### `GET /workflows`
+List automated sequences and workflows.
+
+### `GET /integrations`
+Manage connections to CRMs (Salesforce, HubSpot) and Mail Platforms.
+
+### `GET /webhooks`
+Configure event-based real-time notifications.

package/references/openapi.json

@@ -0,0 +1,215 @@
+{
+    "openapi": "3.0.3",
+    "info": {
+        "title": "LeadGenius Pro Agent API",
+        "description": "RESTful API for AI agents to manage ABM campaigns and lead lifecycle in LeadGenius Pro",
+        "version": "1.0.0"
+    },
+    "servers": [
+        {
+            "url": "/api/agent",
+            "description": "Agent API Base URL"
+        }
+    ],
+    "paths": {
+        "/campaigns": {
+            "get": {
+                "summary": "List campaigns",
+                "parameters": [
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "integer",
+                            "default": 1
+                        }
+                    },
+                    {
+                        "name": "pageSize",
+                        "in": "query",
+                        "schema": {
+                            "type": "integer",
+                            "default": 20
+                        }
+                    },
+                    {
+                        "name": "status",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    {
+                        "name": "campaignType",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ]
+            },
+            "post": {
+                "summary": "Create campaign",
+                "requestBody": {
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "$ref": "#/components/schemas/Campaign"
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/campaigns/{id}": {
+            "get": {
+                "summary": "Get campaign by ID"
+            },
+            "put": {
+                "summary": "Update campaign"
+            },
+            "delete": {
+                "summary": "Archive campaign"
+            }
+        },
+        "/leads": {
+            "get": {
+                "summary": "List leads",
+                "parameters": [
+                    {
+                        "name": "page",
+                        "in": "query",
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "name": "pageSize",
+                        "in": "query",
+                        "schema": {
+                            "type": "integer"
+                        }
+                    },
+                    {
+                        "name": "status",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    },
+                    {
+                        "name": "campaignId",
+                        "in": "query",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                ]
+            },
+            "post": {
+                "summary": "Create lead"
+            }
+        },
+        "/leads/batch": {
+            "post": {
+                "summary": "Batch create leads"
+            },
+            "delete": {
+                "summary": "Batch delete leads"
+            }
+        },
+        "/enrichment/trigger": {
+            "post": {
+                "summary": "Trigger enrichment"
+            }
+        },
+        "/enrichment/status/{jobId}": {
+            "get": {
+                "summary": "Get enrichment job status"
+            }
+        },
+        "/target-accounts": {
+            "get": {
+                "summary": "List target accounts"
+            },
+            "post": {
+                "summary": "Create target account"
+            }
+        },
+        "/sequences": {
+            "get": {
+                "summary": "List sequences"
+            },
+            "post": {
+                "summary": "Create sequence"
+            }
+        },
+        "/sequences/{id}/enroll": {
+            "post": {
+                "summary": "Enroll leads in sequence"
+            }
+        },
+        "/analytics/pipeline": {
+            "get": {
+                "summary": "Get pipeline metrics"
+            }
+        },
+        "/workflows": {
+            "get": {
+                "summary": "List workflows"
+            },
+            "post": {
+                "summary": "Create workflow"
+            }
+        },
+        "/integrations": {
+            "get": {
+                "summary": "List integrations"
+            },
+            "post": {
+                "summary": "Create integration"
+            }
+        },
+        "/webhooks": {
+            "get": {
+                "summary": "List webhooks"
+            },
+            "post": {
+                "summary": "Create webhook"
+            }
+        }
+    },
+    "components": {
+        "schemas": {
+            "Campaign": {
+                "type": "object",
+                "properties": {
+                    "name": {
+                        "type": "string"
+                    },
+                    "description": {
+                        "type": "string"
+                    },
+                    "campaignType": {
+                        "type": "string",
+                        "enum": [
+                            "abm",
+                            "demand_gen",
+                            "nurture"
+                        ]
+                    },
+                    "status": {
+                        "type": "string",
+                        "enum": [
+                            "draft",
+                            "active",
+                            "paused",
+                            "completed",
+                            "archived"
+                        ]
+                    }
+                }
+            }
+        }
+    }
+}

package/scripts/api_call.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+import argparse
+import json
+import os
+import requests
+import sys
+
+def main():
+    parser = argparse.ArgumentParser(description="Call LeadGenius Pro Agent API")
+    parser.add_argument("method", choices=["GET", "POST", "PUT", "DELETE"], help="HTTP method")
+    parser.add_argument("endpoint", help="API endpoint (e.g., /leads)")
+    parser.add_argument("--data", help="JSON data for POST/PUT requests")
+    parser.add_argument("--base-url", default="http://localhost:3000/api/agent", help="Base URL")
+    parser.add_argument("--key", help="API Key (defaults to LGP_API_KEY env var)")
+
+    args = parser.parse_args()
+
+    api_key = args.key or os.environ.get("LGP_API_KEY")
+    if not api_key:
+        print("Error: API Key is required. Use --key or set LGP_API_KEY environment variable.")
+        sys.exit(1)
+
+    url = f"{args.base_url.rstrip('/')}/{args.endpoint.lstrip('/')}"
+    headers = {
+        "X-API-Key": api_key,
+        "Content-Type": "application/json"
+    }
+
+    try:
+        data = None
+        if args.data:
+            data = json.loads(args.data)
+
+        response = requests.request(args.method, url, headers=headers, json=data)
+        
+        print(f"Status: {response.status_code}")
+        try:
+            print(json.dumps(response.json(), indent=2))
+        except:
+            print(response.text)
+
+    except Exception as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()