https://github.com/imsovikde/souvik-skills
Marketplace-ready agent skills by Souvik Dey
https://github.com/imsovikde/souvik-skills
ai-agents cloudflare-pages codex motion-design nextjs skills vercel
Last synced: 5 days ago
JSON representation
Marketplace-ready agent skills by Souvik Dey
- Host: GitHub
- URL: https://github.com/imsovikde/souvik-skills
- Owner: imsovikde
- License: mit
- Created: 2026-06-26T17:30:26.000Z (7 days ago)
- Default Branch: main
- Last Pushed: 2026-06-26T18:06:52.000Z (7 days ago)
- Last Synced: 2026-06-26T19:19:00.548Z (7 days ago)
- Topics: ai-agents, cloudflare-pages, codex, motion-design, nextjs, skills, vercel
- Language: JavaScript
- Homepage: https://souvik-skills.vercel.app
- Size: 98.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Souvik Skills
Marketplace-ready agent skills by Souvik Dey.
[](https://github.com/imsovikde/souvik-skills/actions/workflows/ci.yml)
[](https://github.com/imsovikde/souvik-skills/actions/workflows/codeql.yml)
[](https://www.npmjs.com/package/@imsovikde/skills)
[](https://www.npmjs.com/package/@imsovikde/skills)
[](https://github.com/imsovikde/souvik-skills/stargazers)
[](LICENSE)
Souvik Skills is the public skill directory for reusable developer and research workflows created by [Souvik Dey](https://github.com/imsovikde). The repository is designed to work like a professional skill catalog: every skill is a self-contained folder with a `SKILL.md`, optional resources, agent UI metadata, and an NPM-ready installer path.
[Website](https://souvik-skills.vercel.app) · [Skills](https://souvik-skills.vercel.app/skills) · [Install](#cross-agent-install) · [Docs](https://souvik-skills.vercel.app/docs) · [Releases](https://github.com/imsovikde/souvik-skills/releases) · [NPM](https://www.npmjs.com/package/@imsovikde/skills)
## Marketplace Site
The repository includes a Vercel-ready and Cloudflare Pages-ready static Next.js marketplace:
- Vercel: [souvik-skills.vercel.app](https://souvik-skills.vercel.app)
- Cloudflare Pages: [souvik-skills.pages.dev](https://souvik-skills.pages.dev)
- `/` - product homepage
- `/skills` - searchable skill marketplace
- `/skills/` - independent page for every skill folder
- `/install` - cross-agent install matrix
- `/docs` - repository and skill standards
- `/motion` - motion-system examples
Run it locally:
```bash
npm run dev
```
Build the static export:
```bash
npm run build
```
## Skills
| Skill | Purpose |
| --- | --- |
| `delink-github` | Safely remove Git history, GitHub remotes, and root `.github` files before starting clean local history. |
| `gh-ready` | Make repositories SEO-friendly, package-ready, release-ready, badge-ready, secure, and professional for GitHub publication. |
| `magento-team-lead` | Lead Magento Open Source and Adobe Commerce architecture, reviews, debugging, delivery planning, and releases. |
| `motioncraft` | Design and implement premium, accessible, high-performance interface motion systems. |
## Cross-Agent Install
Use the `skills` CLI when installing directly from this GitHub repository into an agent. Replace `` with the agent slug you use, such as `codex`, `claude-code`, `cursor`, or `gemini-cli`. Replace `` with the command that starts the agent when trying a skill once.
### Project Only
```bash
npx -y skills add imsovikde/souvik-skills --skill delink-github --agent
npx -y skills add imsovikde/souvik-skills --skill gh-ready --agent
npx -y skills add imsovikde/souvik-skills --skill magento-team-lead --agent
npx -y skills add imsovikde/souvik-skills --skill motioncraft --agent
```
### Global
```bash
npx -y skills add imsovikde/souvik-skills --skill delink-github --agent -g
npx -y skills add imsovikde/souvik-skills --skill gh-ready --agent -g
npx -y skills add imsovikde/souvik-skills --skill magento-team-lead --agent -g
npx -y skills add imsovikde/souvik-skills --skill motioncraft --agent -g
```
### Try Once
```bash
npx -y skills use imsovikde/souvik-skills@delink-github |
npx -y skills use imsovikde/souvik-skills@gh-ready |
npx -y skills use imsovikde/souvik-skills@magento-team-lead |
npx -y skills use imsovikde/souvik-skills@motioncraft |
```
## Codex Package Install
Install one skill into Codex from the NPM package:
```bash
npx @imsovikde/skills install delink-github
npx @imsovikde/skills install gh-ready
npx @imsovikde/skills install magento-team-lead
npx @imsovikde/skills install motioncraft
```
Install every skill:
```bash
npx @imsovikde/skills install all
```
List available skills:
```bash
npx @imsovikde/skills list
```
By default the installer copies skills into:
```text
%USERPROFILE%\.codex\skills
```
Set `CODEX_HOME` or pass `--dest ` to install elsewhere.
## Use
After installation, restart Codex so the new skill metadata is loaded.
Example prompts:
```text
Use $delink-github to safely detach this repository from GitHub and start clean local Git history.
Use $gh-ready to make this project SEO-friendly, GitHub-ready, package-ready, and release-ready.
Use $magento-team-lead to lead this Adobe Commerce implementation review.
Use $motioncraft to add premium accessible motion to this interface.
```
## Repository Standard
This repository follows the Souvik Skills standard:
- `guidance.md` defines the skill directory rules.
- `AGENTS.md` tells future agents how to create and maintain skills here.
- `NAMING.md` explains how skill and repository names are chosen.
- `LICENSE` grants MIT usage rights.
- `package.json` exposes the one-line NPM installer.
Do not create `context.md`. Use `guidance.md` as the durable repository guide.
## Development
Install dependencies, run the marketplace, and verify the repo:
```bash
npm install
npm run dev
npm run validate:skills
npm test
npm run build
```
Smoke-test the installer locally:
```bash
node bin/souvik-skills.cjs list
node bin/souvik-skills.cjs install all --dest ./tmp/codex-skills --force
```
## Deployment
See [`docs/deployment.md`](docs/deployment.md) for Vercel, Cloudflare Pages, and NPM release commands.
## Support And Troubleshooting
- If `npx -y skills add ...` fails, confirm GitHub can access `imsovikde/souvik-skills` and rerun the command.
- If `npx @imsovikde/skills ...` fails, verify the npm package with `npm view @imsovikde/skills version`.
- If Codex does not show a newly installed skill, restart Codex after installation.
- For bugs or feature requests, use the GitHub issue templates.
- For security concerns, follow `SECURITY.md` instead of opening a public issue.
## License
MIT. See `LICENSE`.