GPT Project Skill System

https://github.com/xxyoudeadpunkxx/chatgpt-skill-system
Admin
GPT Project Skill System brings a skill-package workflow to ChatGPT Projects, allowing users to...
Tokens:7,736
Snippets:119
Trust Score:6.4
Update:4 months ago
Show doc for...
Tokens:
Raw
### Skill Name Identity Example

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

Demonstrates the consistency required for the skill name across command slug, ZIP filename, installed folder, and MANIFEST.json.

```text
SKILL summarizer UNPACK
summarizer.zip
/mnt/data/GPT.SKILLS/SKILLS/summarizer/
```

--------------------------------

### Fallback MANIFEST.json Example

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/SKILL_PACKAGE_FORMAT.md

Example of a minimal MANIFEST.json for a fallback skill.

```json
{
  "skill_name": "summarizer",
  "version": "1.0"
}
```

--------------------------------

### SKILL.md Requirements Example

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

Demonstrates how to specify skill requirements and dependencies within the SKILL.md file as human-readable text.

```markdown
## Requirements

- Needs access to uploaded source files.
- Uses only Project-visible files.
- No internet required.
```

--------------------------------

### Explicit Manifest MANIFEST.json Example

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/SKILL_PACKAGE_FORMAT.md

Example of a comprehensive MANIFEST.json for an explicit manifest skill, detailing various file categories.

```json
{
  "skill_name": "csv-profiler",
  "version": "1.0",
  "primary_file": "SKILL.md",
  "load_sequence": [
    "SKILL.md"
  ],
  "support_files": [
    "docs/columns.md"
  ],
  "tool_files": [
    "tools/profile_csv.py"
  ],
  "asset_files": [
    "templates/template.csv"
  ],
  "capabilities": ["csv analysis"],
  "runtime_hints": {
    "uses_python": true
  }
}
```

--------------------------------

### Invalid Package: Name Mismatch Example

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

Demonstrates a scenario where the skill name in the command does not match the ZIP file name.

```text
SKILL summarizer UNPACK
reviewer.zip
```

--------------------------------

### Example MANIFEST.json for an Explicit Skill

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

An example JSON manifest file for an explicit skill. It specifies the skill's name, version, primary file, load sequence, and other file types like support, tool, and asset files.

```json
{
  "skill_name": "example",
  "version": "1.0",
  "primary_file": "any/safe/path/SKILL.md",
  "load_sequence": ["any/safe/path/SKILL.md"],
  "support_files": ["docs/reference.md"],
  "tool_files": ["tools/helper.py"],
  "asset_files": ["templates/template.csv"]
}
```

--------------------------------

### Valid Skill Name Examples

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

Examples of valid skill names adhering to the slug rule.

```text
summarizer      valid
legal-review    valid
a_b-1           valid
```

--------------------------------

### Basic SKILL.md Example

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

A basic SKILL.md file for the 'Summarizer' skill. It includes a title, a brief description of its function, and a requirements section.

```markdown
# Summarizer

Summarize long text while preserving key decisions, constraints, and unresolved questions.

## Requirements

- Needs access to the source text.
- No internet required.
```

--------------------------------

### Invalid Slug Example

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

Shows an example of an invalid slug used in the 'SKILL UNPACK' command, likely due to disallowed characters.

```text
SKILL My Skill UNPACK
```

--------------------------------

### Explicit Manifest Configuration with Extra Files

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

An example of MANIFEST.json for explicit mode, declaring primary file, load sequence, support files, tool files, asset files, capabilities, and runtime hints.

```json
{
  "skill_name": "summarizer",
  "version": "1.0",
  "primary_file": "SKILL.md",
  "load_sequence": ["SKILL.md"],
  "support_files": ["docs/columns.md"],
  "tool_files": ["tools/profile_csv.py"],
  "asset_files": ["templates/template.csv"],
  "capabilities": ["summarization"],
  "runtime_hints": {
    "uses_python": true
  }
}
```

--------------------------------

### Fallback Skill Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

Example structure for a fallback skill where the entry point is SKILL.md at the root of the zip file.

```text
skill.zip
  MANIFEST.json
  SKILL.md
```

--------------------------------

### Invalid Manifest: Skill Name Mismatch

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

An example of an invalid MANIFEST.json where the 'skill_name' does not match the expected skill.

```json
{
  "skill_name": "reviewer",
  "version": "1.0"
}
```

--------------------------------

### Invalid Skill Name Examples

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

Examples of invalid skill names that violate the slug rule.

```text
my skill        invalid
Summarizer      invalid
skill.name      invalid
../x            invalid
x/y             invalid
```

--------------------------------

### Valid ZIP Entry Path

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

An example of a valid path format within a ZIP archive, using POSIX forward slashes.

```text
SYSTEM_CORE/MANIFEST.json
```

--------------------------------

### Invalid ZIP Entry Path

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

An example of an invalid path format within a ZIP archive, using backslashes instead of forward slashes.

```text
SYSTEM_CORE\MANIFEST.json
```

--------------------------------

### Build Output Files

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

Indicates the output files generated by the build process, including a main skill package and individual skill ZIP files.

```text
dist/GPT.SKILLS.zip
dist/skills/*.zip
```

--------------------------------

### Valid Skill Package Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/SKILL_PACKAGE_FORMAT.md

Demonstrates a correctly structured ZIP file for a skill package, with MANIFEST.json at the root and other files/folders organized appropriately.

```text
csv-profiler.zip
  MANIFEST.json
  SKILL.md
  docs/
  tools/
  templates/
```

--------------------------------

### Unpack and Load Commands

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

The standard commands used to unpack and load a skill into the system.

```text
SKILL <name> UNPACK
SKILL <name> LOAD
```

--------------------------------

### Build Skill Packages

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

Command to build skill packages using a Python script. The build process validates various aspects of the package structure and content.

```bash
python scripts/build_packages.py
```

--------------------------------

### Core Package Directory Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/GPT.SKILLS/SYSTEM_CORE/README.md

This shows the expected directory structure for the core package of the GPT Project Skill System.

```text
GPT.SKILLS/
  SYSTEM_CORE/
  SKILLS/
```

--------------------------------

### Repository Layout

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

This shows the directory structure of the GPT Project Skill System repository.

```text
GPT.SKILLS/
  SYSTEM_CORE/
  SKILLS/

skill_sources/
  skill-adapter/

dist/
  GPT.SKILLS.zip
  skills/
    skill-adapter.zip

docs/
  ADAPTING_A_SKILL.md
  PACKAGING.md
  SKILL_PACKAGE_FORMAT.md

scripts/
  build_packages.py
```

--------------------------------

### Fallback Skill Package Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/SKILL_PACKAGE_FORMAT.md

A fallback skill package is a flat ZIP archive containing MANIFEST.json and SKILL.md.

```text
summarizer.zip
  MANIFEST.json
  SKILL.md
```

--------------------------------

### Fallback Mode Loader Configuration

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/SKILL_PACKAGE_FORMAT.md

If primary_file and load_sequence are omitted, the loader defaults to fallback mode using SKILL.md.

```json
{
  "primary_file": "SKILL.md",
  "load_sequence": ["SKILL.md"]
}
```

--------------------------------

### Correct ZIP Root Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/PACKAGING.md

When creating the GPT.SKILLS.zip package, ensure the root of the zip file contains the SYSTEM_CORE and SKILLS directories directly. This is the expected structure for the SKILL CORE UNPACK utility.

```text
SYSTEM_CORE/
SKILLS/
```

--------------------------------

### Minimal Fallback Skill Manifest

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

A minimal JSON manifest required for a fallback skill, including the skill name and version.

```json
{
  "skill_name": "example",
  "version": "1.0"
}
```

--------------------------------

### Invalid Fallback Skill Package Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

An invalid fallback skill package structure includes a wrapper directory around the manifest and skill files.

```text
summarizer.zip
  summarizer/
    MANIFEST.json
    SKILL.md
```

--------------------------------

### Explicit Skill Manifest Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/README.md

Defines the structure of a skill package with a MANIFEST.json file and other supporting files. Use this when a skill requires a declared entry point, preserved folders, support files, scripts, or assets.

```text
skill.zip
  MANIFEST.json
  any/safe/path/SKILL.md
  docs/
  tools/
  templates/
```

--------------------------------

### Explicit Manifest Skill Package Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/SKILL_PACKAGE_FORMAT.md

An explicit manifest skill package can preserve internal folder structures from the source.

```text
csv-profiler.zip
  MANIFEST.json
  SKILL.md
  docs/
    columns.md
  tools/
    profile_csv.py
  templates/
    template.csv
```

--------------------------------

### Invalid Skill Package Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/SKILL_PACKAGE_FORMAT.md

Illustrates an incorrectly structured ZIP file where a wrapper directory encloses the package contents, which is a hard fail condition.

```text
csv-profiler.zip
  csv-profiler/
    MANIFEST.json
    SKILL.md
```

--------------------------------

### Valid ZIP Entry Names

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/PACKAGING.md

ZIP entries must use forward slashes ('/') as path separators. This ensures cross-platform compatibility and correct parsing by the runtime environment.

```text
SYSTEM_CORE/MANIFEST.json
SKILLS/README.md
```

--------------------------------

### Invalid ZIP Entry Names

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/PACKAGING.md

Do not use backslashes ('\') as path separators in ZIP entry names. The build script will fail if any generated or checked ZIP contains '\' in an entry name.

```text
SYSTEM_CORE\MANIFEST.json
SKILLS\README.md
```

--------------------------------

### Adaptation Report Schema Structure

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/skill_sources/skill-adapter/references/adaptation_report_schema.md

This schema defines the required sections for reporting an external skill adaptation. It includes fields for compatibility status, source details, loader mode, manifest draft, various compatibility checks, findings, operator decisions, and maximum supported claims.

```text
Compatibility: PASS | PASS_WITH_WARNINGS | BLOCKED

Source:
- input:
- inspected shape:
- existing manifest:

Loader mode:
- fallback | explicit
- reason:

Manifest draft:
- skill_name:
- version:
- primary_file:
- load_sequence:
- support_files:
- tool_files:
- asset_files:

Compatibility checks:
- path safety:
- ZIP safety:
- UTF-8 mounted files:
- physical file availability:
- Python tool compatibility:
- external mechanisms:
- dependency assumptions:

Findings:
- severity:
- file:
- issue:
- fix:

Operator decisions:
- ...

Maximum supported claim:
- ...
```

--------------------------------

### Valid Skill Name Slug Pattern

Source: https://github.com/xxyoudeadpunkxx/chatgpt-skill-system/blob/main/docs/ADAPTING_A_SKILL.md

Defines the allowed characters for a skill name slug: lowercase letters, digits, underscore, and hyphen.

```text
^[a-z0-9_-]+$
```
Tokens:
Raw