Introduce 'paths_filter' option along with new return values

action.yml

@@ -17,6 +17,13 @@ inputs:
     description: 'A JSON-array with path patterns, e.g. something like ["platform-specific/**"]'
     required: false
     default: '[]'
+  paths_filter:
+    description: |
+      A YAML-string with named paths_ignore/paths patterns, e.g.
+      app:
+        paths:
+          - 'app/**/*'
+    required: false
   cancel_others:
     description: 'If true, then workflow-runs from outdated commits will be cancelled'
     required: false
@@ -36,8 +43,14 @@ inputs:
 outputs:
   should_skip:
     description: 'Returns true if the current run should be skipped according to your configured rules. This should be evaluated for either individual steps or entire jobs.'
+  reason:
+    description: 'The reason why the current run is considered skippable or unskippable.'
   skipped_by:
-    description: 'Information about the workflow run which caused the current run to be skipped.'
+    description: 'Information about the workflow run which caused the current run to be skipped. Returns information only when current run is considered skippable.'
+  changed_files:
+    description: 'A two-dimensional array, with a list of changed files for each commit that was traced back. Returns information only if one of the options "paths_ignore", "paths" or "paths_filter" is set.'
+  paths_result:
+    description: 'Returns an object with information like "should_skip" for each named "paths_filter".'
 runs:
   using: 'node12'
   main: 'dist/index.js'