@hasna/skills 0.1.25 → 0.1.26

package/dist/lib/config.d.ts

@@ -12,6 +12,7 @@ export interface SkillsConfig {
     defaultAgent?: "claude" | "codex" | "gemini" | "pi" | "opencode" | "all";
     defaultScope?: "global" | "project";
     format?: "compact" | "json" | "csv";
+    apiUrl?: string;
 }
 export type ConfigScope = "global" | "project";
 /**

package/dist/lib/registry-sync.d.ts

@@ -0,0 +1,53 @@
+import { type SkillRegistryProfile } from "./registry.js";
+import { type SkillDocs, type SkillRequirements } from "./skillinfo.js";
+import { type SkillValidationResult } from "./skill-validation.js";
+export interface RegistrySyncOptions {
+    profile?: SkillRegistryProfile;
+    includeDocs?: boolean;
+    includeRequirements?: boolean;
+    includeValidation?: boolean;
+    packageName?: string;
+    packageVersion?: string;
+    sourceRepository?: string;
+}
+export interface RegistrySyncSkill {
+    name: string;
+    slug: string;
+    displayName: string;
+    description: string;
+    category: string;
+    tags: string[];
+    dependencies: string[];
+    source: {
+        packageName: string;
+        packageVersion: string;
+        repository: string;
+        directory: string;
+    };
+    docs?: SkillDocs & {
+        best: string | null;
+    };
+    requirements?: SkillRequirements | null;
+    validation?: SkillValidationResult;
+}
+export interface RegistrySyncArtifact {
+    schemaVersion: 1;
+    source: {
+        packageName: string;
+        packageVersion: string;
+        repository: string;
+        profile: SkillRegistryProfile;
+    };
+    summary: {
+        skillCount: number;
+        validSkillCount: number | null;
+        invalidSkillCount: number | null;
+        categories: Array<{
+            name: string;
+            count: number;
+        }>;
+    };
+    skills: RegistrySyncSkill[];
+}
+export declare function createRegistrySyncArtifact(options?: RegistrySyncOptions): RegistrySyncArtifact;
+export declare function writeRegistrySyncArtifact(path: string, artifact: RegistrySyncArtifact): void;

package/dist/lib/registry.d.ts

@@ -8,7 +8,7 @@ export interface SkillMeta {
     category: string;
     tags: string[];
     dependencies?: string[];
-    source?: "official" | "custom";
+    source?: "official" | "custom" | "remote";
 }
 export declare const CATEGORIES: readonly ["Development Tools", "Business & Marketing", "Productivity & Organization", "Project Management", "Content Generation", "Finance & Compliance", "Data & Analysis", "Media Processing", "Design & Branding", "Web & Browser", "Research & Writing", "Science & Academic", "Education & Learning", "Communication", "Health & Wellness", "Travel & Lifestyle", "Event Management"];
 export type Category = (typeof CATEGORIES)[number];

package/dist/lib/remote-registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Remote registry client.
+ *
+ * Local registry behavior remains the default. These helpers are opt-in and
+ * read from SKILLS_API_URL or config.apiUrl so private SaaS products can expose
+ * a compatible registry API without hard-coding any SaaS details upstream.
+ */
+import { type SkillsConfig } from "./config.js";
+import type { SkillMeta } from "./registry.js";
+export interface RemoteRegistryOptions {
+    apiUrl?: string;
+    endpoint?: string;
+    timeoutMs?: number;
+    fetchImpl?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+}
+export declare function getConfiguredApiUrl(config?: SkillsConfig, env?: Record<string, string | undefined>): string | undefined;
+export declare function buildSkillsApiUrl(apiUrl: string, endpoint?: string): string;
+export declare function parseRemoteRegistryPayload(payload: unknown): SkillMeta[];
+export declare function loadRemoteRegistry(options?: RemoteRegistryOptions): Promise<SkillMeta[]>;

package/dist/lib/skill-validation.d.ts

@@ -0,0 +1,45 @@
+import type { SkillMeta } from "./registry.js";
+export interface SkillValidationMessage {
+    code: string;
+    message: string;
+}
+export interface SkillValidationResult {
+    name: string;
+    path: string;
+    valid: boolean;
+    issues: SkillValidationMessage[];
+    warnings: SkillValidationMessage[];
+    metadata: {
+        packageName?: string;
+        version?: string;
+        binCommands: string[];
+        docFiles: string[];
+        skillMdFrontmatter?: SkillFrontmatter;
+        provenance?: SkillValidationProvenance;
+    };
+}
+export interface RegistryConsistencyResult {
+    valid: boolean;
+    missingDirectories: string[];
+    orphanDirectories: string[];
+    duplicateRegistryNames: string[];
+}
+export interface SkillFrontmatter {
+    name?: string;
+    description?: string;
+    displayName?: string;
+    category?: string;
+    tags?: string[];
+    version?: string;
+    source?: string;
+}
+export interface SkillValidationProvenance {
+    directoryName: string;
+    packageName?: string;
+    packageVersion?: string;
+    frontmatterSource?: string;
+    registrySource?: string;
+}
+export declare function parseSkillFrontmatter(content: string): SkillFrontmatter | null;
+export declare function validateSkillDirectory(name: string, skillPath: string, registryMeta?: SkillMeta): SkillValidationResult;
+export declare function validateRegistryConsistency(registry: SkillMeta[], skillsDir: string): RegistryConsistencyResult;

package/dist/types/api.d.ts

@@ -13,6 +13,7 @@ export interface SkillResponse {
     envVarsSet: string[];
     systemDeps: string[];
     cliCommand: string | null;
+    source?: "official" | "custom" | "remote";
 }
 export interface SkillDetailResponse extends SkillResponse {
     docs: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {

package/skills/scaffold-project/my-app/.env.example

@@ -0,0 +1,2 @@
+# Environment Variables
+

package/skills/scaffold-project/my-app/README.md

@@ -0,0 +1,72 @@
+# my-app
+
+REST API boilerplate
+
+## Tech Stack
+
+- **Framework**: REST API
+- **Language**: TypeScript
+- **Styling**: Tailwind CSS
+
+## Prerequisites
+
+- Node.js 18+ (or Bun)
+- 
+
+## Getting Started
+
+1. Install dependencies:
+
+```bash
+bun install
+```
+
+2. Copy environment variables:
+
+```bash
+cp .env.example .env
+```
+
+3. Fill in the environment variables in `.env`
+
+5. Run the development server:
+
+```bash
+bun dev
+```
+
+## Available Scripts
+
+- `bun dev` - Start development server
+- `bun build` - Build for production
+- `bun start` - Start production server
+- `bun lint` - Run ESLint
+- `bun format` - Format code with Prettier
+
+## Project Structure
+
+```
+my-app/
+├── src/
+│   ├── app/          # Application routes
+│   ├── components/   # React components
+│   ├── lib/          # Utility functions
+│   └── types/        # TypeScript types
+├── public/           # Static assets
+├── .env.example      # Environment variables template
+├── package.json
+└── README.md
+```
+
+## Learn More
+
+- [REST API Documentation](https://nextjs.org/docs)
+- [Tailwind CSS](https://tailwindcss.com/docs)
+
+## Deployment
+
+Deploy your application on [Vercel](https://vercel.com) or [Railway](https://railway.app).
+
+---
+
+Generated with [scaffold-project](https://skills.md/skills/scaffold-project)

package/skills/scaffold-project/my-app/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "my-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint .",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "express": "latest",
+    "cors": "latest",
+    "dotenv": "latest",
+    "tailwindcss": "latest",
+    "autoprefixer": "latest",
+    "postcss": "latest"
+  },
+  "devDependencies": {
+    "@types/express": "latest",
+    "@types/cors": "latest",
+    "@types/node": "latest",
+    "typescript": "latest",
+    "tsx": "latest",
+    "eslint": "latest",
+    "prettier": "latest"
+  }
+}

package/skills/scaffold-project/my-app/src/index.ts

@@ -0,0 +1,23 @@
+import express from 'express'
+import cors from 'cors'
+import dotenv from 'dotenv'
+
+dotenv.config()
+
+const app = express()
+const port = process.env.PORT || 3000
+
+app.use(cors())
+app.use(express.json())
+
+app.get('/', (req, res) => {
+  res.json({ message: 'API is running' })
+})
+
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok' })
+})
+
+app.listen(port, () => {
+  console.log(`Server running on http://localhost:${port}`)
+})

package/skills/scaffold-project/my-app/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": [
+      "ES2020",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ]
+    }
+  },
+  "include": [
+    "src"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}