share-skill

Push local skill metadata and file bundles to a Notion skills database.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill share-skill-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: share-skill
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/skill-dev/share-skill
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill share-skill-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Sharing a locally built skill with your team requires manually copying metadata, packaging files, and creating database entries, which is error-prone and often skipped. This Skill automates publishing a local skill to the company's Notion skills database with validation, duplicate detection, and mandatory confirmation. ## Core Features & Use Cases - Automated Upload Pipeline: Validates SKILL.md frontmatter, bundles all skill files (scripts, references, assets) into a base64-encoded JSON package, and uploads it via the Notion File Upload API. - Duplicate Protection & Versioning: Blocks overwrites of existing skills, supports semantic version tracking, and offers an --as-new flag for publishing improved versions as separate entries. - Guided Metadata Mapping: Infers the appropriate Team, sets Owner from user-config.yaml, and requires a dry-run preview with explicit user confirmation before pushing. - Use Case: After creating a new query-notion-db skill locally, run this Skill to preview the upload, confirm the Team assignment, and publish it so anyone in the company can discover it in Notion. ## Quick Start Push my local skill from 03-skills/my-skill to the Notion skills database with a dry-run preview first.

Frequently Asked Questions about share-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push a local skill to a Notion database?

Run the upload script with the skill path and team, for example: python upload_skill.py 03-skills/my-skill --team General. The script validates SKILL.md, bundles all files into JSON, and creates the Notion entry after your confirmation.

How do I preview a skill upload to Notion before pushing?

Add the --dry-run flag to the upload command to see a preview summary including skill name, version, team, owner, bundle size, and file count. No changes are made to Notion until you rerun without the flag.

What happens if the skill already exists in Notion?

The upload is blocked and the script shows the existing skill's owner, version, and URL. Overwriting is not allowed; use --as-new with a different name to publish an improved version, or delete the old entry manually in the Notion UI.

What SKILL.md fields are required for Notion upload validation?

The YAML frontmatter must contain name and description, and the description should include trigger phrases. Version must follow semantic versioning like 1.0 or 1.0.0, defaulting to 1.0 if omitted.

Why does the Notion skill upload return a 401 Unauthorized error?

A 401 error means the Notion API key is invalid or missing. Check that NOTION_API_KEY and NOTION_SKILLS_DB_ID are correctly set in your .env file, or run the setup wizard script to reconfigure.