Metadata-Version: 2.5
Name: gncore
Version: 5.1.0
Summary: A searchable Python catalog of portable AI agent skills.
Project-URL: Homepage, https://github.com/paladuguganeshnaidu/gncore
Project-URL: Repository, https://github.com/paladuguganeshnaidu/gncore
Project-URL: Documentation, https://github.com/paladuguganeshnaidu/gncore#readme
Project-URL: Bug Tracker, https://github.com/paladuguganeshnaidu/gncore/issues
Author-email: Ganesh Naidu <ganesh.naidu@example.com>
License: MIT
License-File: LICENSE
Keywords: agent-skills,ai,assistant,machine-learning,skill-library,skills
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Provides-Extra: test
Requires-Dist: pytest>=8.2; extra == 'test'
Description-Content-Type: text/markdown

# GNCore

GNCore is a Python library and CLI for discovering and installing reusable AI agent skills. Its 403 skills cover 30 domain packs and are distributed as standard `SKILL.md` folders.

## Install

```bash
python -m pip install gncore
```

## Discover and use skills

```bash
gncore list domains
gncore search "machine learning training"
gncore show train
gncore export --skills train evaluate
```

By default, `export` installs the selected skills into `.agents/skills/<skill-id>/SKILL.md` in the current project. Agent tools that discover `.agents/skills/` can load the instructions, examples, and commands from these folders.

Install one skill by its exact ID, install the full catalog, or choose another destination:

```bash
gncore export --specific design-ux-audit
gncore export --all
gncore export --skills train --directory ./my-agent/skills
```

To retain the portable ZIP workflow, pass `--output` explicitly:

```bash
gncore export --skills train evaluate --output ml-skills.zip
```

The Python API can be used directly:

```python
from gncore import get_skill, list_domains, search_skills

skill = get_skill("train")
print(skill.prompt)
print([domain.name for domain in list_domains()])
print([item.metadata.skill_id for item in search_skills("clean data")])
```

Browse the [complete skill catalog](docs/ALL_SKILLS.md).

## CLI

- `gncore list [skills|domains|categories]`
- `gncore search <terms> [--category <name>]`
- `gncore show <skill-id>`
- `gncore export (--skills <id>... | --specific <id> | --all) [--directory <path> | --output <file.zip>]`
- `gncore version`

## Development

```bash
python -m pip install -e ".[test]"
python -m pytest -q
python scripts/generate_skill_catalog.py
```

See [Architecture](ARCHITECTURE.md), [Usage](docs/USAGE.md), [API](docs/API.md), and [Developer Guide](docs/DEVELOPER.md).

## License

MIT. See [LICENSE](LICENSE).
