Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions LICENSE.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# License

Third-party files under `wiki/skills/` are excluded from the CC BY 4.0
grant below. They retain the upstream MIT licenses listed in
`wiki/sources.json` and reproduced in `wiki/licenses/`.
Reference-only catalog entries do not grant rights to their implementations.
Linked third-party skills are not redistributed or relicensed by this project.
Third-party snapshots in earlier Git revisions retain their upstream MIT
licenses, recorded in `wiki/sources.json` and `wiki/licenses/`.
The current tree publishes original work and links to other authors' sources.

This project is licensed under the Creative Commons Attribution 4.0
International License (CC BY 4.0).
Expand Down
5 changes: 5 additions & 0 deletions PUBLICATION_POLICY.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@

This repository contains sanitized AI workflow templates only.

Publish original, privacy-reviewed skills and workflows. For skills obtained
from other authors, include a short directory description and a link to the
original repository, not a copied implementation. Unknown provenance is not
evidence of authorship; leave those implementations unpublished until reviewed.

Do not commit:

- secrets, tokens, credentials, private URLs, or webhook endpoints
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ work.
## What this is

For a browsable reference, see the [skills and workflows wiki](wiki/README.md):
505 distinct public skill entries, 268 attributed MIT definition copies, and
the 19 existing workflow playbooks. The wiki distinguishes copied source from
reference-only entries and records its inventory limits.
505 distinct skill entries and 19 workflow playbooks. Original skills are
published here; other authors' skills link to their original repositories.
Unverified ownership stays separate and is not claimed as original work.

`agentic-workflows` turns AI workflows into repo-native operating files:
validate them, render runbooks, audit authority, and compile them into agent
Expand Down
18 changes: 14 additions & 4 deletions tests/wiki.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,16 +9,26 @@ test('public catalog has distinct identities and reconciled counts', () => {
expect(new Set(skills.map(entry => entry.name)).size).toBe(skills.length);
expect(catalog.entries.filter(entry => entry.type === 'workflow')).toHaveLength(19);
expect(catalog.distinctSkillNames - catalog.withheldPrivateSkills).toBe(skills.length);
expect(skills.filter(entry => entry.availability === 'Reference copy')).toHaveLength(268);
expect(catalog.referenceCopies).toBe(0);
expect(skills.filter(entry => entry.origin === 'Original work')).toHaveLength(catalog.originalSkillCount);
expect(skills.filter(entry => entry.origin === 'Other authors')).toHaveLength(catalog.upstreamSkillCount);
expect(skills.filter(entry => entry.origin === 'Unverified')).toHaveLength(catalog.unverifiedSkillCount);
expect(catalog.originalSkillCount + catalog.upstreamSkillCount + catalog.unverifiedSkillCount).toBe(skills.length);
});

test('every copied definition and existing playbook resolves to a real file', () => {
for (const entry of catalog.entries) {
if (!entry.documentation) continue;
test('original skills and playbooks resolve locally; third-party skills link upstream', () => {
for (const entry of catalog.entries.filter(entry => entry.origin === 'Original work')) {
expect(entry.documentation).toStartWith('https://github.com/ftchvs/agentic-workflows/blob/main/');
const path = entry.documentation.split('/blob/main/')[1];
expect(existsSync(path)).toBe(true);
expect(readFileSync(path, 'utf8').trim().length).toBeGreaterThan(50);
}
for (const entry of catalog.entries.filter(entry => entry.origin === 'Other authors')) {
expect(entry.documentation).toBe(entry.source);
expect(entry.documentation).not.toContain('github.com/ftchvs/agentic-workflows');
expect(entry.availability).toBe('Upstream link');
}
expect([...new Bun.Glob('wiki/skills/**/SKILL.md').scanSync('.')]).toHaveLength(0);
for (const source of sources) {
expect(source.license).toBe('MIT');
expect(readFileSync(source.licensePath, 'utf8')).toContain('Permission is hereby granted');
Expand Down
35 changes: 20 additions & 15 deletions wiki/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,9 @@ the source. This wiki expands the original seven-library design catalog.
| --- | ---: | --- |
| Distinct skill names reviewed | 511 | Inventory denominator |
| Public skill entries | 505 | Names, short descriptions, categories, and available sources |
| MIT reference copies | 268 | Definition snapshots from the seven credited libraries |
| Original published skills | 10 | Full source in this repository's skills folder |
| Other authors' skills | 362 | Links to original repositories or maintained sources |
| Ownership not verified | 133 | Reference entries only; not claimed as original work |
| Existing public workflow playbooks | 19 | Reusable playbooks already in this repository |
| Private-project skills withheld | 6 | Names and instructions are not published |

Expand All @@ -23,7 +25,8 @@ review; they are not silently represented as public workflows.
- [Skill directory](catalog.md): one row per distinct skill name.
- [Machine-readable catalog](catalog.json): the same public entries.
- [Workflow playbooks](../workflows): existing Markdown and executable templates.
- [Sources and licenses](sources.json): upstream attribution for copied material.
- [Original published skills](../skills): reusable source maintained here.
- [Source history](sources.json): attribution for the seven original libraries.

## Use a skill

Expand All @@ -33,13 +36,15 @@ review; they are not silently represented as public workflows.
relevant files, constraints, and the checks you expect.
4. Review the result. A skill is guidance, not evidence that work succeeded.

The files under `wiki/skills` are documentation snapshots, not an installation
bundle. Referenced scripts, assets, and supporting documents remain upstream.
Use the source links in the catalog to obtain the complete maintained package.
The English directory summarizes the skills; snapshots retain their original
language. Supporting-file links are pinned to verified upstream commits.
Thirteen references across three snapshots were absent upstream and are
explicitly marked as unavailable text rather than left as broken links.
Publish original, privacy-reviewed skills in `skills/`. For another author's
skill, follow the original repository link for installation, instructions,
dependencies, and licensing. Do not copy its implementation into this wiki.
An installed skill with no source is not automatically original work: ownership
must be established before publishing it as such.

The 268 third-party definition snapshots from the first edition have been
removed from the current tree. They remain recoverable in Git history; no
history rewrite was performed. Local installed skills are unchanged.

## Distinct entries

Expand All @@ -58,15 +63,15 @@ or hidden platform instructions are exported. Source ownership and licensing
for reference-only entries remain unreviewed. Listing an entry does not place
its implementation under this repository's license.

The 268 snapshots retain their upstream MIT licenses, collected in
[licenses](licenses). Original wiki prose and the existing repository workflow
material remain CC BY 4.0. Changes to snapshot formatting or links must be
identified. These copies preserve the installed definition text except for
supporting-link repairs, unavailable-reference labels, and trailing whitespace.
Original wiki prose, published skills, and workflow material use CC BY 4.0.
Third-party implementations remain in their upstream repositories under their
authors' licenses. Historical snapshot notices remain in [licenses](licenses)
for attribution of earlier revisions, not as a license for linked content.

## Keep it current

Review the source, license, and privacy boundary before adding a copy. Keep
Review ownership and privacy before publishing original work. Link to upstream
for other authors' skills; keep uncertain ownership unpublished. Keep
`catalog.json` and `catalog.md` aligned. Run the repository validation and wiki
tests before publishing. Refresh the portfolio copy from the same catalog,
not from a separate handwritten list.
Loading
Loading